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Introduction 


The Microsoft C Reference contains essential information about the language, 
run-time library, and utility programs that comprise version 6.0 of the Microsoft 
C Professional Development System. This book is aimed at the experienced pro- 
grammer who needs a particular fact—the meaning of an option, the syntax of a 
pragma, the arguments to a library function. Much of the information is in lists 
and tables, organized to help you find it at a glance. 


The C Reference is designed to complement the other Microsoft C documenta- 
tion, including Installing and Using the Professional Development System, 
Advanced Programming Techniques, and the Advisor (on-line help). For ex- 
ample, while /nstalling and Using introduces you to Microsoft C and teaches you 
how to use the Programmer’s WorkBench (PWB), the C Reference assumes that 
you are already familiar with using PWB. Thus, it lists all the functions and keys- 
trokes, both alphabetically and by use, as well as return values and editor 
switches—but it does not teach you how to use them. Youll find a discussion 
about how to optimize C programs to best advantage in Advanced Programming 
Techniques. In this C Reference you'll find a complete list of all the compiler op- 
tions, including those for optimization, and a short description of what each one 
does—but not which is best in a particular situation. 


About This Book 


The parts of this book and what they contain are discussed below. 


Utilities 

Part 1 of the Microsoft C Reference summarizes the utility programs included 
with the Microsoft C Professional Development System. The utilities are listed al- 
phabetically. A brief description and the syntax appear at the beginning of each 
utility’s description, followed by command-line options. ‘The description may 
also include other useful information. For example, the coverage of LINK lists 
module-definition file statements used in Windows and OS/2 applications; the 
pages on the CodeView® debugger list dialog commands as well as size and for- 
mat specifiers. 


Language Reference 


Part 2 includes the basic elements of the C language: it lists keywords and escape 
sequences, and gives the syntax and a short explanation of statements, preproces- 
sor directives, and pragmas. It also provides tables of information on operators 
and data type sizes. 
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Run-Time Library Functions 


The Microsoft C libraries contain over 500 functions. Part 3 of this book first 
lists the functions by category. It then provides an alphabetical overview of each 
function, listing the function prototype, the include file, the parameter list, a brief 
description, and compatibility. 


Appendixes 


The appendixes contain various useful tables, such as one on printf and scanf 
formatting codes. They also list compiler limits and program limits at run time, 
the data ranges defined in LIMITS.H, and the numerical values defined in 
FLOAT.H. Finally, there are numeric and ASCU conversion tables. 


NOTE The pages that follow use the term “OS/2” to refer to the OS/2 systems—Microsoft 
Operating System/2 (MS@ OS/2) and IBMe OS/2. Similarly, the term “DOS” refers to both 
the MS-DOS® and IBM Personal Computer DOS operating systems. The name of a specific 
operating system is used when it is necessary to note features that are unique to the system. 


Document Conventions 


This book uses the following document conventions : 


Example Description 


STDIO.H Uppercase letters indicate file names, segment 
names, registers, and terms used at the 
operating-system command level. 


_far Boldface letters indicate C keywords, operators, 
language-specific characters, and library routines. 
Within discussions of syntax, bold type indicates 
that the text must be entered exactly as shown. 


expression Words in italics indicate placeholders for informa- 
tion you must supply, such as a file name. Italics are 
also occasionally used for emphasis in the text. 


[loption|]| Items inside double square brackets are optional. 
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#pragma pack {112} 


include <io.h> 
CL options [files...]] 


while() 
{ 


: : 


CTRL+ENTER 


“argument” 


“ee SUE AG: 


Color Graphics 
Adapter (CGA) 


Braces and a vertical bar indicate a choice among 
two or more items. You must choose one of these 
items unless double square brackets surround the 
braces. 


This font is used for examples, user input, program 
output, and error messages in text. 


Three dots following an item indicate that more 
items having the same form may appear. 


A column of three dots tells you that part of the 
program has been intentionally omitted. 


Small capital letters are used for the names of keys 
on the keyboard. When you see a plus sign (+) be- 
tween two key names, you should hold down the 
first key while pressing the second. 


The carriage-return key, sometimes marked as a 
bent arrow on the keyboard, is called ENTER. 


The cursor-movement keys are called the arrow 
keys. Individual keys are referred to by their direc- 
tion (LEFT, UP) or by the name on the key (PGUP). 


Quotation marks enclose a new term the first time it 
is defined in text. 


Some C constructs, such as strings, require quotation 
marks. Quotation marks required by the language 
have the form and ' ' rather than“ ” and’ ’. 


The first time an acronym 1s used, it is often 
spelled out. 


oe poate 


SSiheianse 


3 BIND 


summary The BIND utility converts protected-mode programs that use Family API functions to 
access system services, allowing them to run in both real mode and protected mode. 


Syntax BIND infile [[implibs] [linklibs]| [[/O outfile]| [[/N@file]] [[/N functions] [/Mmapfile]| 


In the syntax above, infile contains the name of the OS/2 application, implibs contains the 
name of one or more import libraries, and Jinklibs contains the name of one or more stan- 
dard libraries and object files. 


Options /HELP Provides on-line help for BIND. First BIND attempts to ex- 
ecute the QuickHelp program, QH.EXE. If QuickHelp or its 
database is unavailable, the /HELP option lists BIND syntax 
and options to the standard output. 


/M[[AP]] mapfile Causes a link map to be generated to mapfile for the real 
mode environment of the executable file. 

/N[AMES ]] functions Allows the listing of functions supported in protected mode 
only. Use with a list of functions or a file specification 
preceded by @. 

/NOLOGO Suppresses display of the sign-on banner. 

/OJ[UTFILE] outfile. Specifies the name for the bound application, outfile. 


[? Displays the syntax of the BIND utility. 
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Summary The CL utility compiles and links one or more C source files. 

Syntax CL [loptions || [| filename] ... [libraries link-options]| 

Options /A {TISIMICILIH } Selects one of these standard memory models: | 
Option Comments 
/AT Tiny memory model. Code and data are 


limited to 64K total. Must link with 
CRTCOM.LIB. Creates a .COM file for 
real mode. (Same as /Asnd.) 


/AS Small memory model. Code and data are 
limited to 64K each. (Same as /Asnd.) 


/AM Medium memory model. Data is limited to 
64K. (Same as /Alnd.) 


/AC Compact memory model. Code is limited to 
64K. (Same as /Asfd.) 


/AL Large memory model. No limits on code or 
data. (Same as /Alfd.) 


/AH Huge memory model. Same as large model, 
but individual arrays can exceed 64K. 
(Same as /Alhd.) 


/Astring Sets up a customized memory model. The string consists of 
three characters in any order, indicating code and data pointer 
size and segment setup. 


Group Code __ Description 
Code pointers S Small (Near) 
] Large (Far) 
Data pointers n Near 
f Far 
h Huge 
Segment setup d SS == DS 
u SS != DS; DS loaded for —_ 


each function entry 
SS != DS; DS not loaded 
w at function entry 
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/B1 [[path] Invokes an alternative preprocessor called C1L.EXE. Use this 
option to compile programs that generate the message 
the compiler is out of near heap. The drive and 
path where C1L.EXE resides are optionally specified in path. 


/B2 [[path]| Invokes an alternative compiler pass two called C2L.EXE. 

/B3 [[path]| Invokes an alternative compiler pass three called C3L.EXE. 

IC Preserves comments when preprocessing a file; use only with 
/E, /P, or /EP. 

Ic Compiles without linking. Creates an object file but not an ex- 


ecutable file. 


/D id [ = [value] ]] Defines the symbolic constant id to the preprocessor. If value 
is defined, the value of id is value. If the equal sign is given 
without value, the value of id is empty. If id is given without 
the equal sign, the value of id is 1. 


/E Preprocesses the source file, copying the result to the standard 
output and inserting #line directives. 


/EP Preprocesses the source file, copying the result to the standard 
output without #line directives. 


/F hexnum Sets stack size to hexnum bytes (this is the same as 
[link /STACK:number). The value must be expressed in 
hexadecimal notation. 


/Fa |[listfile]] Produces an assembly listing. If listfile is unspecified, /Fa 
defaults to sourcefilename.ASM. Not available with the /qc 
option. 

/Fobound-exe Creates a bound executable file. Use only with /Lp. 

/Fe [[listfile]| Produces a combined source-assembly code listing. If listfile 


is unspecified, /Fc defaults to sourcefilename.COD. Not avail- 
able with the /qc option. 


/Fe exefile Names the executable file. 

/Fl (listfile]] Generates an object-code listing. If listfile is not given, /Fl 
defaults to sourcefilename.COD. Not available with the /qc 
option. 

/Fm [[mapfile]] Creates a linker map file. If mapfile is not given, /Fm defaults 


to first-sourcefilename.MAP. 


/Fo objfile Names the object file. 
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/FPa 


/FPc 


/FPc87 


/FPi 


/FP187 


/Fr [[browsefile]] 


/FR [[browsefile]] 


/Fs [[listfile]] 


/Fx|[xreffile]] 


/GO 


/G1 
/G2 
/Gc 


/Gd 
/Ge 
/Gi 


/Gm 


Generates floating-point calls and selects the alternate math li- 
brary. Not available with the /qc option. 


Generates floating-point calls and selects the emulator library 
(which uses an 80x87 coprocessor if one is present). Not avail- ae 
able with the /qc option. 


Generates floating-point calls and selects an 80x87 library 
(which requires an 80x87 coprocessor at run time). Not 
available with the /qc option. 


Generates in-line 80x87 instructions and selects an emulator li- 
brary (uses an 80x87 coprocessor if one is present). This is the 
default /FP option. 


Generates in-line 80x87 instructions and selects an 80x87 li- 
brary (which requires an 80x87 coprocessor at run time). 


Generates a standard PWB Source Browser database. If 
browsefile is unspecified, /Fr defaults to basename.SBR. 


Generates an extended Source Browser database. If browsefile 
is unspecified, /FR defaults to basename.SBR. 


Produces a source listing. If listfile is unspecified, /Fs defaults 
to sourcefilename.LST. Not available with the /qc option. 


Specifies a name for the Microsoft Macro Assembler 
(MASM) cross-reference file. If xreffile is unspecified, /Fx 
defaults to sourcefilename.CRF. 


Generates 8086/8088 instructions. This is the default /G 
option. 


Generates 80186/80188 instructions. 
Generates 80286 instructions. 


Specifies use of FORTRAN- or Pascal-style function calling 
and naming conventions. 


Specifies standard (default) C calling conventions. 
Enables calls to the stack-checking routine (default). 


Compiles incrementally (when used in conjunction with the 
/qc option); only functions that have changed are recompiled. 
Without /qc, /Gi incrementally links by padding object files. 
Implies /L1. 


Stores strings in the constant (CONST) segment. Not 
available with the /qc option. 


/Gr 


/Gs 


/Gtlnumber] 


/Gw 


/GW 


/H number 


/HELP 


/I directory 


/J 
/Le 


/Liflnumber || 


/Lp 

/Lr 

/link link-libinfo 
/MAMASM option 


/MD 
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Enables the new _fastcall function to call conventions for 
eligible functions. When possible, values are passed in regis- 
ters instead of on the stack. 


Suppresses generation of calls to the stack-checking routine. 


Places data items greater than or equal to number bytes in a 
new segment. Default is 256 if no number is specified. 


Generates entry/exit code sequences suitable for use in 
Microsoft Windows applications. 


Same as /Gw, but generates more efficient entry sequences. 
Used for code other than user callback functions. 


Restricts external names to number significant characters. The 
default is 31 characters. Not available with the /qc option. 


Calls the QuickHelp utility. If the QuickHelp program is not 
available, CL displays the most commonly used options to the 
standard output. This option is not case sensitive. 


Adds directory to the beginning of the list of directories to be 
searched for include files. 


Changes the default for char type from signed to unsigned. 


Causes the linker to create a compatibility mode executable 
file. Same as /Lr. 


Invokes the incremental linker ILINK instead of the standard 
linker LINK. ILINK runs faster than LINK while creating 
larger executable files. The optional number specifies the byte 
boundary to which the linker pads all near functions. 


Causes the linker to create a protected-mode executable file. 
Causes the linker to create a real-mode executable file. 
Passes linker options or library names in /ink-libinfo to LINK. 


Passes the specified option to the Microsoft Macro Assembler 
(MASM). MASM is automatically invoked for files listed on 
the command line with the extension .ASM. 


Creates a dynamically linked C run-time library (OS/2 only). 
Equivalent to /ALw /FPi /G2 /DDLL/DMT. No library search 
record. 


Statically links the C run-time library as part of a dynamic- 
link library (OS/2 only). Equivalent to /ALw /FPa /G2 /DMT. 
Library search record is changed to LLIBCDLL.LIB. 
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/MT 


/NDdataseg 
/NMmodule 
/nologo 
/NTtextseg 
/O[lopt_codes]| 


Enables support for multithread programs (OS/2 only). Equiv- 
alent to /ALw /FPi /G2 /DMT. Library search record is 
changed to LLIBCMT.LIB. 


Sets the data segment name. 


Sets the module name. 


_ Suppresses display of the sign-on banner. 


Sets the code segment name. 


Controls optimization. When no codes are included, default 
optimization is enabled. The optional opt_codes argument 
may contain one or more of the following characters: 


Code 


a 


C 


Description 


Assumes no aliasing 


Enables default (block-level) local common 
expressions 


Disables all optimizations 
Enables global register allocation 


Enables global optimizations and global 
common expressions 


Enables generation of intrinsic routines 
Enables loop optimizations 
Disables unsafe loop optimizations (default) 


Improves consistency in floating-point 
calculations 


Disables in-line returns from functions 
Favors smaller code size 
Favors faster execution speed (default) 


Assumes no aliases except across function 
calls (not available with the /qc option) 


Maximizes optimizations (equivalent to 
/Oecilgt/Gs) 


Enables maximum loop and global-register- 
allocation optimization 


/qc 


/SI linewidth 


/Sp pagelength 


/Ss subtitle 
/St title 


[Ta asm_srcfile 


/Tc c-srcfile 


/u 
/U identifier 
/V string 


/w 


/W{01 1121314} 


/Zd 


[Ze 
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Preprocesses the source file and sends output to a file 
having the base name of the source file and the extension .I 
(basename.]). 


Invokes the quick compile option. The following options pro- 
duce an error during a quick compile: /Fa, /Fc, /Fl, /FPa, /FPc, 
/FPc87, /Fs, /Gm, /H, /Ow, /Zc. 


Sets the line width of source listing in characters per line. 
Range is 79-132. Default is 79. 


Sets the page length of source listing in lines per page. Range 
is 15-255. Default is 63. 


Specifies subtitle for source listing. 
Specifies title for source listing. 


Specifies that asm_srcfile is to be treated as an assembler 
source file, whether or not it has an .ASM extension. 


Indicates that c-srcfile is a C source file, whether or not it has 
a .C extension. 


Removes (undefines) definitions of all predefined identifiers. 
Removes the definition of the given predefined identifier. 
Copies the version string to the object file. 

Suppresses compiler warning messages; same as /WO. 


Sets the output level for compiler warning messages. The de- 
fault is 1. 


Makes all warnings fatal; no object file is generated when a 
warning occurs. 


Ignores the list of “standard places” in the search for include 
files. 


Enforces American National Standards Institute (ANSI) 
language compatibility, disabling extensions specific to 
Microsoft C. 


Causes functions declared as _pascal to be treated without re- 
gard to case. Not available with the /qc option. 


Generates line-number information required for the SY MDEB 
debugger. 


Enables extensions specific to Microsoft C. This is the default 
/Z option. 


CL (Compiler) 
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/Zg 


[Zi 


/Z\ 


/Zpf{1!214}]] 
/Zr 


/Zs sourcefiles 


Generates function prototypes from function definitions and 
writes declarations to standard output, without compiling the 
program. 


Generates symbolic information required by the Microsoft 
CodeView® window-oriented debugger. 


Suppresses emission of library search records in the object file. 
Packs structure members on the specified byte boundary. 


Generates code that checks for null pointers and out-of-range 
far pointers (in the CL command, use only with /qc). 


Performs a syntax check only. 
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CodeView 


Summary 


Syntax 


Options 


The Microsoft CodeView window-oriented debugger runs the compiled program while 
simultaneously displaying the program source code, program variables, memory locations, 
processor registers, and other pertinent information. 


CV [[options]| executablefile [arguments] 


To debug protected-mode programs, set IOPL = YES in your CONFIG.SYS file and use 


the following syntax: 


CVP |[loptions]| executablefile [larguments]| 


j2 


/Ccommands 
/D\buffersize]| 
/E 

/F 

[number 

[K 

/L dynlib 

/M 


/Nnumber 
/O 


/R 


Permits the use of two monitors 

Starts in 25-line mode 

Starts in EGA 43-line mode 

Starts in VGA 50-line mode 

Starts in black-and-white mode with CGA or EGA 
Executes commands on start up 

Enables disk overlays (DOS only) 

Enables Expanded Memory Support (EMS) (DOS only) 


Does not’ swap video pages between CodeView and the pro- 
gram you are debugging; exchanges debug and output screens 
by flipping between video pages (faster than /S) 


Turns nonmaskable interrupts and 8259-interrupt trapping on 


(/I1) or off (/10) 


Disables installation of keyboard monitors for the program 
being debugged 


Enables Code View to search OS/2 dynamic-link libraries for 
symbolic information 


Disables Code View support of the mouse (use this option 
when debugging an application that supports the mouse) 


/NO tells CodeView to trap; /N1 tells it not to 


Enables debugging of multiple processes under OS/2 pro- 
tected mode 


Enables 80386 debug registers (not available under OS/2) 
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/S Starts with screen swapping (exchanges screens by changing 
buffers, primarily for use with graphics programs) 
[X Uses extended memory to increase debugging capacity (DOS 
only) 
CodeView Commands 

Action Keyboard Mouse 

Display help about the selected topic Fl Click Help menu 

Display contents of help SHIFT+F1 Click Help menu Contents 
command 

Go to next help screen CTRL+F1 — 

Go to previous help topic SHIFT+CTRL+Fl1 — 

Go to previously viewed help screen ALT+F1 Click Back button on help 
screen 

Toggle register window F2 Click View menu 
Registers command 

Toggle source/assembly/mixed modes F3 Click Options menu Source 
Window command 

Toggle memory window formats SHIFT+F3 Click Options menu Memory 
Window command 

Switch to output screen F4 Click View menu Output 
command 

Close window CTRL+F4 Click button in upper left 
corner of window 

Go to next Breakpoint or to program end F5 Click Left button on Go on 
status line 

Switch to next window F6 Click desired window 

Switch to previous window SHIFT+F6 Click desired window 

Execute to cursor F7 Click Right button at location 
on status line 

Trace into procedure F8 Click Left button on Trace 

Display previous command in history SHIFT+F8 — 

Change window size CTRL+F8 Click Left button on window 
border and drag 

Toggle Breakpoint at line with cursor F9 at location Double-click Left button at 


location and drag 


Step over procedure F10 Click Left button on Step 


Action 


Display next command in history 


Maximize window 
Change flag in register window 


Delete character at cursor 
Toggle insert and overstrike modes 


Copy text into delete buffer 
Paste text from delete buffer 
Move to next command (Command 


window only) 


Move to previous command (Command 
window only) 

Find selected text 

Repeat last find 

Add Watch expression 

Delete Watch expression 

Open Quick Watch window for a variable 
Scroll up one line in window 

Scroll down one line in window 

Scroll up one page in window 


Scroll down one page in window 


Scroll window to the left 


Scroll window to the right 


Move cursor to beginning of line 


Keyboard 


SHIFT+F10 
CTRL+F10 


Any printing 


character 
DEL 

INS 
CTRL+INS 


SHIFT+INS 


TAB 


SHIFT+TAB 


CTRL+\ 


ALT+/ 


CTRL+W 


CTRL+U 


SHIFT + F9 


CTRL+UP 


CTRL+DOWN 


PGUP 


PGDN 


CTRL+PGUP 


CTRL+PGDN 


HOME 


CodeView 


Mouse 


Click button in upper right 
corner of window 


Double-click Left button on 
flag 


Click Edit menu Copy 
command 


Click Edit menu Paste 
command 


Click Left button at location 
Click Left button at location 


Click Search menu Selected 
Text command 


Click Search menu Repeat 
Find command 


Click Watch menu Add 
Watch command 


Click Watch menu Delete 
Watch command 


Click Watch window Quick- 
Watch command 


Click Left button on up arrow 
on scroll bar 


Click Left button on down 
arrow on scroll bar 


Click Left button above verti- 
cal elevator 


Click Left button below verti- 
cal elevator 


Click Left button on left 
arrow or to left of horizontal 
elevator 


Click Left button on right 
arrow or to right of horizontal 
elevator 


Click Left button at location 


CodeView 


Action 


Move cursor to end of line 


Scroll to top of file 
Scroll to end of file 


Move cursor one word 


Move cursor one line 
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Dialog Commands 


Name 


address 
Add Watch 
Assemble 


Breakpoint 
Clear 


Breakpoint 
Disable 


Breakpoint 
Enable 
Breakpoint List 


Breakpoint Set 


Comment 


Keyboard Mouse 

END Drag elevator to bottom 

CTRL+HOME Drag vertical elevator to top 

CTRL+END Drag elevator to bottom 

CTRL+LEFT/ Click Left button at location 

CTRL+RIGHT 

UP/DOWN Click Left button at location 
Syntax Description 


[| [segment | register]: lloffset 
(type *) constant 

W? expression, format] 

A [laddress]| 

BC {list | * } 

BD {list | * } 

BE {list |* } 


BL 


BP [address] |[=symboll[range] ]] | 
[[? expression] ||, passcount]| 
[[,"' commands" ]| 


* comment 


Identifies the location of an expres- 
sion in various commands 


Displays expression or memory 
range in the Watch window 


Assembles mnemonics starting at 
address 


Clears breakpoints in /ist or in all 
breakpoints (*) 


Turns off breakpoints in Jist or in all 
breakpoints (*) 


Enables breakpoints in /ist or in all 
breakpoints (*) 


Lists breakpoints with the status of 
each 


Breaks execution when address is 
reached 


Breaks execution when the value of 
expression changes; if address is 
listed, the expression is evaluated 
only at that address 


Breaks execution when expression 
is true; 1f address is listed, the ex- 
pression is evaluated only at that 
address 


Displays explanatory text 
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Name 


Compare 
Memory 


Current 
Location 


Delay 


Delete Watch 


Display 
Expression 


Dump 


Enter 


Examine 
Symbols 


Execute 


Fill Memory 


Go 
List Watch 
Move Memory 


Options 


Pause 


Port Input 
Port Output 
Program Step 


Quick Watch 


Quit 


Syntax 


C range address 


Y {number | *} 


? expression|, format] 
D[ltype]] [laddress | range] 


E|[type]] address ([list] 
X([LI*!? [module!]] [[function.]] 
[symbol] "1 I 

E 


F range list 


G [[breakaddress]| 
WwW 
M range address 


Olloption|[[+ | -] ] 


I port 
O port byte 
P [[count]| 


2? symbol 


Q 


CodeView 


Description 


Compares bytes in range with bytes 
beginning at address; displays any 
mismatched pairs 


Displays the current location 


Delays execution of redirected com- 
mands (may be repeated for longer 
delays) 


Deletes (yanks) Watch statements 


Displays expression in format 


Dumps memory address or range in 
type format 


Enters memory value in type format 


Displays specified symbols 


Executes in slow motion 

Fills addresses in range with values 
in list 

Executes to breakaddress or to end 
Lists current Watch statements 


Copies values in range memory 
block to address 


Views or sets Code View options, in- 
cluding bytes coded (B), flip/swap 
(F), case sensitivity (C), show sym- 
bol address (L), symbols (S), or 

386 (3) 


Interrupts execution of redirected 
commands and waits for keystroke 


Reads and displays byte from port 
Sends byte to port 


Executes source lines or instruc- 
tions, stepping over routine, 
procedure, and interrupt calls; 
repeats count times 


Displays local variables and 
complete data structures in a 
dialog box 


Exits and returns to DOS 


CodeView 


16 


Name 


Radix 


Redirection 


Redraw 


Register 


Restart 


Screen 
Exchange 


Search 
Search Memory 
Shell Escape 


Source Display 
Mode 


Stack Trace 
Tab Set 


Trace 


Unassemble 


View 
8087 


Size Specifiers 


Syntax 


N [[radixnumber] 
[ £(TI>[>] ] | < | =Idevicename 


@ 


R [[registername [| [=]lexpression] ]| 


L [larguments]| 
\ [time] 


/ [[regularexpression|]| 
S range list 


' command] 
S[[+1-1 & ]] 


K 


#number 


T [count] 


U [[viewaddress|| 


V I [viewaddress].line number] 
7 


Description 


Sets input radix 


Redirects input or output to or from 
devicename 


Redraws the screen 


Displays registers and flags, or sets 
new registers and flags 


Restarts program 


Exchanges the CodeView and out- 
put screens 


Searches for a regular expression 
Searches range for values in list 


Escapes to anew DOS or OS/2 shell 
and executes command 


Sets display mode to source, 
assembly, or mixed 


Displays active routines on the stack 


Sets number spaces for each tab 
character 


Executes source lines or instruc- 
tions, tracing into routine, pro- 
cedure, or interrupt calls; repeats 
count times 

Displays assembly-language 
instructions 


Displays source lines 


Displays 80x87 registers 


Use these data types with Dump and Enter dialog commands: 


Data Type 


None 
. | 
B 

D 


Description 


Default type 


ASCI (8-bit) characters 


Byte (8-bit) hexadecimal values 


Double-word (32-bit) hexadecimal values 
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Format Specifiers 


Character 


d 


Signed integer (16-bit) decimal values; equivalent to C 
signed int 


Long (64-bit) floating-point (real) values; equivalent to C 
double 


Short (32-bit) floating-point values; equivalent to C float 


10-byte (80-bit) floating-point values; equivalent to C 
long double 


Unsigned integer (16-bit) decimal values; equivalent to C 
unsigned int 


Word (16-bit) hexadecimal values 


Output Format 


Signed decimal integer 
Signed decimal integer 
Unsigned decimal integer 
Unsigned octal integer 
Hexadecimal integer 


Signed value in floating-point decimal format with six deci- 
mal places 


Signed value in scientific-notation format with up to six deci- 
mal places (trailing zeros and decimal point truncated) 


Signed value with floating-point decimal or scientific-notation 
format, whichever is more compact 


Single character 


Characters printed up to the first null character 
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NOTE The prefix h can be used with the integer-type specifiers (d, 0, u, X, and X) to specify a short 
int. The prefix | can be used with the same types to specify a long int. 


Command-Window Commands (Protected Mode) 


Syntax Description 
None Default type 
| Displays process ID number (PID) and session (screen group) 
ID number 
| processID Enables direct debugging of the child process identified 
Thread Commands 
Syntax ~[[specifier[[command] || 


In the syntax above, the specifier specifies the thread or threads, and command determines 
debugging activity. 


The legal values for specifier and their effects are listed below. 


Specifier Function 

Blank Displays the status of all threads. If you omit the specifier 
field you cannot enter a command. Instead, you enter the tilde 
(~) by itself. 

# Specifies the last thread that was executed, which is not neces- 


sarily the current thread. 
ss Specifies all threads. 


number Specifies the indicated thread, where number must be a num- 
ber corresponding to an existing thread. You can determine 
corresponding numbers for all threads by entering the com- 
mand ~*, which gives the status of all threads. 


Specifies the current thread. 
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CodeView 


The legal values for command and their effects are listed below. 


Command 


Blank 
BP 
E 


Function 


Displays the status of the selected thread (or threads). 
Sets the breakpoint for the specified thread or threads. 


Executes the specified thread in slow motion. The command 
~*E is legal only in source mode, where it executes the cur- 
rent thread in slow motion but lets all other unfrozen threads 
run. 


Freezes the specified thread (or threads). A frozen thread will 
not run in the background or in response to the debugger Go 

command. However, if you use the E, G, P, or T variation of 

the Thread command, the specified thread is temporarily un- 

frozen while the debugger executes the command. 


Passes control to the specified thread until it terminates or 
until a breakpoint is reached. If you give the command ~*G, 
all threads execute concurrently (except for those that are 
frozen). If you specify a particular thread, the debugger tem- 
porarily freezes all other threads and executes the specified 
thread. 


Executes a program step for the specified thread. The com- 
mand ~*P is legal only in source mode and causes the debug- 
ger to step to the next source line while letting all other 
threads run (except for those that are frozen). You see only the 
current thread execute in the debugger display. 


Selects the specified thread as the current thread. Can apply to 
only one thread at a time. Thus, the command ~*S results in 
an error message. 


Traces the specified thread. Identical to P, except that T traces 
through function calls and interrupts, whereas P does not. 


Unfreezes the specified thread or threads. Reverses the effect 
of a freeze. 


CodeView 


20 


Effect of Threads on CodeView Commands 


Whether or not you use the Thread Command, the existence of threads affects your 
CodeView debugging session at all times. Particular debugger commands are strongly 
affected. Each of these commands is discussed below. 


Command 


BP 


Behavior in Multiple-Thread Programs 


The Current Location command always uses the current value 
of CS:IP to determine what the current instruction is. Thus, 
the Current Location command applies to the current thread. 


When the debugger is in source mode, the Execute command 
is equivalent to the ~*E command. The current thread is ex- 
ecuted in slow motion while all other threads are also running. 
When the debugger is in mixed or assembly mode, the 
Execute command is equivalent to the command ~.P, which 
does not let other threads run concurrently. 


The Breakpoint Set command is equivalent to the ~*BP com- 
mand; the breakpoint applies to all threads. 


The Go command is equivalent to the ~*G command; control 
is passed to the operating system, which executes all threads 
in the program except for those that are frozen. 


When the debugger is in source mode, the Program Step com- 
mand is equivalent to the command ~*P, which lets other 
threads run concurrently. When the debugger is in mixed or as- 
sembly mode, the Program Step command is equivalent to the 
command ~.P, which lets no other threads run. 


The Stack Trace command displays the stack of the current 
thread. 


When the debugger is in source mode, the Trace command is 
equivalent to the command ~*T, which lets other threads run 
concurrently. When the debugger is in mixed or assembly 
mode, the Trace command is equivalent to the command ~.T, 
which lets no other threads run. 
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Summary The CVPACK utility reads through an .EXE file and combines multiple-module debug- 
ging information into one table at the end of the file. Code View can then load the file more 
quickly. 

Syntax CVPACK [options] filename 

Options /HELP Causes CVPACK to attempt to call the QuickHelp program 


/P Packs the file to the smallest possible size 
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summary The EXEHDR utility displays and modifies the contents of an executable-file header. 

Syntax EXEHDR [options] filename 

Options /HEAP:nnnn Sets the heap allocation field to nnnn for segmented execu- 
table files. 

/HELP Calls the QuickHelp utility. If the QuickHelp program is not 
available, EXEHDR displays the usage message to the stan- 
dard output. 

/MAX:nnnn Sets the maximum allocation field to nnnn paragraphs for 
DOS. 

/MIN:nnnn Sets the minimum allocation field to nnnn paragraphs for 
DOS. 

/NOLOGO Directs EXEHDR to suppress the sign-on banner. 

/PMTYPE:type Sets the window type for Presentation Manager programs, 


where type is one of PM (equivalent to WINDOWAPI), VIO 
(equivalent to WINDOWCOMPAT), or NOVIO (equivalent to 
NOTWINDOWCOMPAT). 


/RESETERROR Resets the error bit in the header of an OS/2 or Windows ex- 
ecutable file. It has no effect on DOS executable files. 


/STACK:nnnn Sets the stack allocation field to nnnn for DOS and segmented- 
executable files. 


/VERBOSE Provides more information about protected mode (OS/2) ex- 
ecutable files and DLLs, including the default flags in the seg- 
ment table, all run-time relocations, and additional fields from 
the .EXE header. 
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Summary The EXP utility expunges (removes) all files from the DELETED subdirectory. Copies of 
deleted files are placed in DELETED by PWB (when the backup switch is on) and by RM. 


Syntax EXP [options] [directory] 


If no directory 1s specified, the current directory’s DELETED subdirectory is used. 


Options /HELP Causes EXP to attempt to call the QuickHelp program 


/Q Specifies quiet mode (the deleted file names are not displayed 
on the screen) 


/R Causes EXP to operate recursively on all subdirectories 
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Summary The HELPMAKE utility creates help files and customizes the help files supplied with 
Microsoft language products. It creates a help database from one or more input files that 
contain information specially formatted for the help system. 

Syntax HELPMAKE [options] {/El[n] |/D} sourcefiles 
You must supply the /HELP, /E (encode), or /D (decode) option. 

Options /Ac Specifies c as an application-specific control character for the 


help database, marking a line that contains special informa- 
tion for internal use by the application. 


IC Indicates that the context strings are case sensitive. At run 
time, all searches for help topics are case sensitive. 


/D{[letter]| Decodes the input file into its component parts. If a destina- 
tion file is not specified with the /O option, the help file is de- 
coded to stdout. HELPMAKE decodes the file in different 
ways, depending on the letter specified. 


Letter 
/D 


/DS 


/DU 


Effect 


“Decode.” Fully decodes the help database, 
leaving all cross-references and formatting 
information intact. 


“Decode split.” Splits the concatenated, 
compressed help database into its com- 
ponents, using their original names. If the 
database was created without concatenation 
(the default), HELPMAKE simply copies it 
to a file with its original name. No decom- 
pression occurs. 


“Decode unformatted.” Decompresses the 
database and removes all screen formatting 
and cross-references. The output can still 
be used later for input and recompression, 
but all of the screen formatting and 
cross-references are lost. 
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HELPMAKE 


/E[[n] 


/HELP 


/K filename 


/L 


/Ooutfile 


Creates (“encodes”) a help database from a specified text file 
(or files). The optional n indicates the amount of compression 
to take place. If n is omitted, HELPMAKE compresses the 
file as much as possible, thereby reducing the size of the file 
by about 50 percent. The more compression requested, the 
longer HELPMAKE takes to create a database file. The value 
of 1 is a number in the range 0-15. It is the sum of successive 
powers of 2 representing these compression techniques: 


Value Technique 

0 No compression 

l Run-length compression 

Z Keyword compression 

4 Extended-keyword compression 
8 Huffman compression 


Add values to combine compression techniques. For example, 
use /E3 to get run-length and keyword compression. 


Displays a summary of HELPMAKE syntax and then exits. 


Calls the QuickHelp utility. If the QuickHelp program is not 
available, HELPMAKE displays the most commonly used 
HELPMAKE options to the standard output (without encod-. 
ing or decoding any files). 


Specifies a file containing word-separator characters. This file 
should consist of a single line of text containing characters 
that separate words. ASCII characters from 0 to 32 (including 
the space), and character 127, are always separators. If the /K 
option is not specified, the following characters are also con- 
sidered separators: 


P"H&'()*+-,/25<5=>?@[\]4_‘{\}~ 


Locks the generated file so that it cannot be decoded by 
HELPMAKE at a later time. 


Specifies outfile as the name of the help database. The name 
outfile is optional with the /D option. 


HELPMAKE 
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[Sn 


/Vin]] 


[Wn 


Specifies the type of input file, according to the following n 
values: 


Option File Type 

/S1 Rich Text Format (RTF) 

[S2 QuickHelp Format (default) 
/S3 Minimally Formatted ASCII 


During encoding, translates dot commands to application- 
specific commands. During decoding, translates application 
commands to dot commands. 


Indicates the “verbosity” of diagnostic and informational out- 
put, depending on the value of n. If you omit this option or 
specify only /V, HELPMAKE gives you its most verbose out- 
put. The possible values of n are listed below: 


/V Maximum diagnostic output 

[VO No diagnostic output and no banner 

[V1 Prints only HELPMAKE banner 

[V2 Prints pass names 

[V3 Prints contexts on first pass 

[V4 Prints contexts on each pass 

IV5 Prints any intermediate steps within each 
pass 

/V6 Prints statistics on help file and compression 


Indicates the fixed width of the resulting help text in number 
of characters. The value of n can range from 11 to 255. If /W 
is omitted, the default is 76. When encoding RTF source 
(/S1), HELPMAKE automatically formats the text to n. When 
encoding QuickHelp (/S2) or minimally formatted ASCII 
(/S3) files, HELPMAKE truncates lines to 1 characters. 
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Summary The ILINK utility invokes the Microsoft Incremental Linker. 
Syntax ILINK [options|] projname [[modulelist] 
Options /A Directs ILINK to check for changes in the object files since 
the last linking process. 
/C Specifies case sensitivity for all public symbol names. 
/E "commands" Specifies commands to be executed if incremental linking 


fails. The option /E "LINK /INC" is the default. 


/HELP Provides on-line help about the incremental linker. First 
/HELP attempts to execute the QuickHelp program QH.EXE. 
If QuickHelp or its database is unavailable, /HELP lists 
ILINK options to the standard output. 


/I Specifies that only an incremental link is to be attempted. If 
the incremental link fails, a fatal error follows the incremental 
violation message. 


/NOLOGO Causes ILINK to suppress the sign-on banner. 
/V Verbose mode. Directs ILINK to list all changed modules. 
[X Prevents ILINK from allocating memory from an expanded 


memory manager if one is present. 


LIB 
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Summary 


Syntax 


Options 


Commands 


The LIB utility helps create, organize, and maintain run-time libraries. 


LIB inlibrary [options]| [commands] [,[/istfile]] [,[loutlibrary]] J 11; I 


/HELP 


/[I[GNORECASE] 


/NOE[XTDICTIONARY ] 
/NOI[[GNORECASE]| 


/NOL[OGO] 
/PA[.GESIZE]]:n 


+filename 


filename 


—tfilename 


*filename 


—*filename 


Provides on-line help for LIB. First 
/HELP attempts to execute the QuickHelp 
program QH.EXE. If QuickHelp or its 
database is unavailable, /HELP lists the 
LIB options to the standard output. 


Directs LIB to ignore case when compar- 
ing symbols (the default). Use to combine 
a library marked /NOI with an unmarked 

library for a new unmarked library. 


Prevents LIB from creating an extended 
dictionary. 


Directs LIB not to ignore case when com- 
paring symbols. 


Causes LIB to suppress the sign-on banner. 


Specifies the library-page size of a new li- 
brary, or changes the library-page size of 
an existing library. The default page size 
for a new library is 16 bytes. 


Appends an object file or library file to 
the given library 


Deletes a module from the library 


Replaces a module by deleting it from the 
library and appending to the library an ob- 
ject file with the same name 


Extracts a module without deleting it from 
the library and saves the module as an 
object file with the same name 

(copies it) 


Extracts a module and deletes it from the 
library after saving it in an object file with 
the same name (moves it) 


NOTE Place an ampersand (&) at the end of an input line to continue the command codes on the 


next line. 
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Summary The Microsoft Segmented-Executable Linker (LINK) combines object files into a single 
executable file. 


Syntax LINK [options] objfiles |[,[[exefile]] [[,[| mapfile]] [libraries] [[,deffile] J VN 03] 


Options /A /ATLIGNMENT]: size 


Directs LINK to align segment data in the executable file 
along the boundaries specified by size, where size must be a 
power of two. Default is 512. 


/BA /BA[TCH] 


Suppresses prompts for library or object files not found. LINK 
generates error or warning messages instead, if appropriate. 
Also prevents LINK from printing the sign-on banner and 
echoing input from response files. 


/CO /CO[DEVIEW ] 


Creates a special-format executable file containing the sym- 
bolic data and line-number information needed by the 
Microsoft CodeView debugger. 


/CP /CP[ARMAXALLOC]:bytes 
Sets the program’s maximum memory allocation to bytes. 
/DO /DO[SSEG] 


For assembly-language programs only. Forces segments in 
the executable file to be ordered as follows: 


1. Segments with class name ending in CODE 
2. All other segments outside DGROUP 
3. DGROUP segments, in the following order: 


a. Segments of class 
BEGDATA 


b. Segments not of class 
BEGDATA, BSS, or STACK 


c. Segments of class 
BSS 


d. Segments of class 
STACK 
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/DS 


/HE 


/HI 


[INC 


/INF 


/LI 


/DS[ ALLOCATE] 


For assembly-language programs only. Directs the linker to 
load all data starting at the high end of the data segment in- 
stead of the low end. 


/EI -XEPACK] 


Packs the executable file during linking by removing repeated 
series of bytes. 


/F[ARCALLTRANSLATION] 


Directs the linker to optimize far calls to procedures that lie in 
the same segment as the caller. Use in conjunction with 
/PACKCODE. Far-call translation is turned on by default. 


/HEILLP]] 


Provides on-line help about the linker. First LINK attempts to 
execute the QuickHelp program QH.EXE. If QuickHelbp or its 
database is unavailable, LINK lists all available options to the 
standard output. 


/HI|GH]] 


Places the executable file as high in memory as possible. For 
real-mode assembly-language programs only. 


AINC[REMENTAL] 


Prepares for subsequent incremental linking with ILINK. In- 
compatible with /E and /TINY. 


/AINF[ORMATION] 


Causes the linker to display phase of linking and names of ob- 
ject files being linked to the standard output. 


/LI[INENUMBERS]] 


Includes source-file line numbers and associated addresses in 
the map file. In addition, an object file with line-number infor- 
mation must be given to LINK. The /Zd option can be used 
with most Microsoft compilers to include line numbers in the 
object file. If LINK is given an object file without line- 
number information, the /LI option has no effect. 


/MITAP]] 


Creates a listing file containing all public (global) symbols de- 
fined in the input modules. 
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/NOD /NOD[EFAULTLIBRARYSEARCH] [[;filename] 


Causes default libraries to be ignored. If filename is specified, 
LINK searches all libraries except filename. 


/NOE /NOE[XTDICTIONARY] 


Prevents the linker from searching the extended dictionary (an 
internal list of intermodule dependencies). Use this option to 
suppress error messages about multiple symbol definitions. 


/NOF /NOF[ARCALLTRANSLATION]] 


Turns off far-call translation (translation of far calls to near 
calls where possible). Far-call translation is off by default. 


/NOI /NOI[GNORECASE]| 


Causes the linker to distinguish between uppercase and lower- 
case letters. 


/NOL /NOL[OGO] 
Causes the linker to suppress the sign-on banner. 
/NON /NON[ULLSDOSSEG] 


Directs the linker to arrange segments in the executable file in 
the same order as they are arranged by the /DOSSEG option, 
with no additional bytes at the beginning of the TEXT seg- 
ment (if it is defined). 


/NOP /NOP[ACKCODE]| 


Turns code-segment packing off (if code-segment packing has 
been turned on). 


/O /O[.VERLAYINTERRUPT]:number 


Allows the user to select an interrupt number other than 63 
(the default) for passing control to overlays. 


/PACKC /PACKC[ODE]] [[:number]| 


Directs the linker to group neighboring code segments to- 
gether in the medium, large, and huge memory models, where 
number specifies the maximum size of groups formed by 
/PACKCODE. When used with /FARCALLTRANSLATION, 
this produces smaller code. 
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/PACKD 


/PADC 


/PADD 


/PAU 


/PM 


/Q 


/SE 


/ST 


/PACKDJ[ATA ] [[:number] 


Directs the linker to group neighboring data segments to- 

gether in the compact, large, and huge memory models, where 
number specifies the maximum size of groups formed by —_ 
/PACKDATA. 


/PADC[ODE]|:padsize 


Directs the linker to add filler bytes to the end of each code 
module for subsequent linking with ILINK; padsize specifies 
the number of bytes. 


/PADD[ATA ]|:padsize 
Adds padsize bytes to each data segment. 
/PAU[SE] 


Causes the linker to pause in the linking session so that disks 
can be changed. This option is provided for floppy-disk users. 


/PM[[TYPE]|:type 


Sets the window type for Presentation Manager (PM) pro- 
grams, where type is: 


Type Windows Equivalent 

PM WINDOWAPI keyword in a module 
definition (.DEF) file 

VIO WINDOWCOMPAT 

NOVIO NOTWINDOWCOMPAT 

/Q(UICKLIB]] 


Produces a Quick library for use with Microsoft QuickCe@ 
(early versions only) or Microsoft QuickBASIC. 


/SEJ. GMENTS]]:number 


Sets the maximum number of segments the program can have, 
which can be any positive value up to 3,072 bytes. The default 
is 128. 


/STIACK ]:number — 


Sets the stack size to number, which can be any positive value 
up to 65,535 bytes. The default for C programs is 0x800 
(2,048) bytes. 
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Default File-Name Extensions 


File Type 

Object 

Executable 

Map 

Standard Library 
Dynamic-Link Library 


Module Definitions 


Module-Definition Files 


/TILINY I] 


Causes the linker to produce .COM files. Incompatible with 
/INCREMENTAL. 


/W[_ARNFIXUP] 


Issues a warning for each segment offset previously at the 
beginning of a group but altered during linking to no longer 
be at the beginning of a group. 


Default Extension 


OBJ 

.EXE (or .COM with /T option) 
MAP 

.LIB 

DLL (OS/2 and Windows only) 
.DEF (OS/2 and Windows only) 


A module-definition file is required for Windows applications and libraries and for 
dynamic-link libraries (DLLs) that run under OS/2. Such files are optional (but desirable) 
for all OS/2 applications. Each file contains one or more module statements that describe 
the module name, attributes of program segments, and number and names of exported and 
imported functions. Following the list of module statements below is a description of each 
one, including syntax and fields. 


NAME 
LIBRARY 
DESCRIPTION 


SEGMENTS HEAPSIZE 
STACKSIZE PROTMODE 
EXPORTS OLD 
IMPORTS REALMODE 


STUB EXETYPE 
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NAME Statement 


Summary 
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The NAME statement identifies the executable file as an application and optionally defines 


the name and type. 


NAME [lapp_name]] [app_type] 


Name of the application. Can be any valid file name. 


{ WINDOWAPI | WINDOWCOMPAT | 
NOTWINDOWCOMPAT } 


Defines the type of application to be linked in a Windows en- 
vironment. WINDOWAPI specifies a Presentation Manager 
(PM) application using the API provided by PM and must be 
executed in the PM environment. This is equivalent to linker 
option /PMTYPE:PM. WINDOWCOMPAT specifies a PM- 
compatible application that can run inside a PM window or in 
a separate screen group using the proper subset of OS/2 video, 
keyboard, and mouse functions supported in PM applica- 
tions. This is equivalent to linker option /PMTYPE:VIO. 
NOTWINDOWCOMPAT specifies that the application is not 
compatible with PM and must operate in a separate screen 
group from PM. This is equivalent to linker option 
/PMTYPE:NOVIO. 


The LIBRARY statement identifies the executable file as a dynamic-link library. It can 
specify the name of the library or the type of library-module initialization required. 


LIBRARY [[libraryname]] [initialization] 


Syntax 

Fields app name 
app_ltype 

LIBRARY Statement 

Summary 

Syntax 

Fields libraryname 


initialization 


Name of the library. Can be any valid file name. 
{ INITGLOBAL | INITINSTANCE} 


Determines the type of initialization required. INITGLOBAL 
specifies that the library-initialization routine is called only 
when the library module is initially loaded into memory. 
INITINSTANCE specifies that the library-initialization routine 
is called each time a new process gains access to the library. 
This option is necessary for DLLs that use the C library 
functions. 
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The DESCRIPTION statement inserts the specified text into the application or library. 


DESCRIPTION ‘text' 


The text is a one-line string enclosed in single quotation marks. 


The CODE statement defines the default attributes for code segments within the applica- 
tion or library. The SEGMENTS statement can override this default. 


CODE [load] [[executeonly] [[iopl]] [conforming] [shared] [movable] [[discard] 


Each attribute field can appear one time at most, and order is not significant. 
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DESCRIPTION Statement 

Summary 

Syntax 

CODE Statement 

Summary 

Syntax 

Fields load 
executeonly 
iopl 
conforming 


{PRELOAD | LOADONCALL} 


Determines when a code segment is loaded. PRELOAD speci- 
fies that the segment is loaded automatically at the beginning 
of the program. LOADONCALL (default) specifies that the 
segment is not loaded until accessed. 


{EXECUTEONLY | EXECUTEREAD} 


Determines whether a code segment can be read as well as ex- 
ecuted. EXECUTEONLY specifies that the segment can only 
be executed. EXECUTEREAD (default) specifies that the seg- 
ment can be both executed and read. 


{IOPL | NOIOPL} 


Determines whether or not a segment has I/O privilege (OS/2 
only). IOPL specifies that the code segment has I/O privilege. 
NOIOPL (default) specifies that the code segment does not 
have I/O privilege. 


{ CONFORMING | NONCONFORMING } 


Determines whether or not a code segment is a 80286 “con- 
forming” segment. CONFORMING specifies that the segment 
is conforming, which means it can be called from either Ring 
2 or Ring 3 and it executes at the caller’s privilege level. 
NONCONFORMING (default) specifies that the segment is 
nonconforming. 
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{SHARED | NONSHARED} 


Determines whether all instances of the program can share an 
EXECUTEREAD code segment. SHARED specifies that one 
copy of the code segment is loaded and shared among all 
processes accessing the module (the default for dynamic-link 
libraries). NONSHARED specifies that the segment cannot be 
shared and must be loaded separately for each process (the de- 
fault for applications). : 


{MOVABLE | FIXED} 


Determines whether a segment can be moved around in 
memory. For use with real-mode Windows only. FIXED is the 
default. 


{DISCARDABLE | NONDISCARDABLE} 


Determines whether a segment of memory can be discarded to 
fill a different memory request. If the discarded memory con- 
tains a function that is called later, it is reloaded from disk. 
For use with real-mode Windows only. NONDISCARDABLE 
is the default. 


The DATA statement defines the default attributes for the data segments within the applica- 


tion or module. 


DATA [load] [readonly] [linstance]] [iop/]] [shared] [movable] [discard] 


Fach field attribute can appear one time at most, and order is not significant. 


shared 
movable 
discard 
DATA Statement 
Summary 
Syntax 
Fields load 
readonly 


{PRELOAD | LOADONCALL} 


Determines when a code segment is loaded. PRELOAD speci- 
fies that the segment is loaded automatically at the beginning 
of the program. LOADONCALL (default) specifies that the 
segment is not loaded until accessed. 


{READONLY | READWRITE} 


Determines access rights to a data segment. READONLY 
specifies that the segment can only be read. READWRITE 
(default) specifies that the segment can be both read and 
written to. 


3/7 


LINK (Linker) 


a eee a a I ea a A aC PS 


instance 


iopl 


shared 


movable 


discard 


SEGMENTS Statement 


{NONE | SINGLE | MULTIPLE} 


Affects the sharing attributes of the automatic data segment 
represented by the group name DGROUP. NONE specifies 
that no automatic data segment is created. SINGLE specifies 
that a single automatic data segment is shared by all instances 
of the module (default for dynamic-link libraries). MULTIPLE 
specifies that the automatic data segment is copied for each in- 
stance of the module (default for applications). 


{IOPL | NOIOPL} 


Determines whether or not a segment has I/O privilege (OS/2 
only). IOPL specifies that the code segment has I/O privilege. 
NOIOPL (default) specifies that the code segment does not 
have I/O privilege. 


{SHARED | NONSHARED } 


Determines whether all instances of the program can share an 
EXECUTEREAD code segment. SHARED specifies that one 
copy of the code segment is loaded and shared among all 
processes accessing the module (the default for dynamic-link 
libraries). NONSHARED specifies that the segment cannot be 
shared and must be loaded separately for each process (the de- 
fault for applications). 


{MOVABLE | FIXED} 


Determines whether a segment can be moved around in 
memory. For use with real-mode Windows only. FIXED is the 
default. 


{DISCARDABLE | NONDISCARDABLE} 


Determines whether a segment of memory can be discarded 
when not needed. If the discarded memory contains data that 
is accessed later, it is reloaded from disk. For use with real- 
mode Windows only. NONDISCARDABLE is the default. 


Summary The SEGMENTS statement defines the attributes of one or more segments in the applica- 
tion or library on a segment-by-segment basis. The attributes specified by this statement 
override defaults set in CODE and DATA statements. 


Syntax SEGMENTS [ ' ] segmentname[l' ] (ICLASS ‘classname’ ]| load] ||readonly] 
[[executeonly]] [iop!]] [conforming] [shared] [movable] [discard] 
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Fields 


The SEGMENTS keyword marks the beginning of the segment definitions. This keyword 
can be followed by one or more segment definitions, each on a separate line (limited by 
the number set by the linker’s /SEGMENTS option, or 128 if the oe is not used). The 
CLASS keyword specifies the class of the segment. 


load 


readonly 


executeonly 


iopl 


conforming 


{ PRELOAD | LOADONCALL } 


Determines when a code segment is loaded. PRELOAD speci- 
fies that the segment is loaded automatically at the beginning 
of the program. LOADONCALL (default) specifies that the 
segment is not loaded until accessed. 


{READONLY | READWRITE} 


Determines access rights to a data segment. READONLY 
specifies that the segment can only be read. READWRITE 
(default) specifies that the segment can be both read and 
written to. 


{ EXECUTEONLY | EXECUTEREAD} 


Determines whether a code segment can be read as well as ex- 
ecuted. EXECUTEONLY specifies that the segment can only 
be executed. EXECUTEREAD (default) specifies that the seg- 
ment can be both executed and read. 


{IOPL | NOIOPL} 


Determines whether or not a segment has I/O privilege (OS/2 
only). IOPL specifies that the code segment has I/O privilege. 
NOIOPL (default) specifies that the code segment does not 
have I/O privilege. 


{ CONFORMING | NONCONFORMING } 


Determines whether or not a code segment is a 80286 “con- 
forming” segment. CONFORMING specifies that the segment 
is conforming, which means it can be called from either Ring 
2 or Ring 3 and it executes at the caller’s privilege level. 
NONCONFORMING (default) specifies that the segment is 
nonconforming. 
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shared 


movable 


discard 


STACKSIZE Statement 


{SHARED | NONSHARED } 


Determines whether all instances of the program can share an 
EXECUTEREAD code segment. SHARED specifies that one 
copy of the code segment is loaded and shared among all 
processes accessing the module (the default for dynamic-link 
libraries). NONSHARED specifies that the segment cannot be 
shared and must be loaded separately for each process (default 
for applications). 


{MOVABLE | FIXED} 


Determines whether a segment can be moved around in 
memory. For use with real-mode Windows only. FIXED is the 
default. 


{DISCARDABLE | NONDISCARDABLE } 


Determines whether a segment of memory can be discarded to 
fill a different memory request. If the discarded memory con- 
tains a function that is called later, it is reloaded from disk. 
For use with real-mode Windows only. NONDISCARDABLE 
is the default. 


summary The STACKSIZE statement specifies the size of the stack segment. (The STACKSIZE state- 
ment overrides the /STACKSIZE linker option.) 


Syntax STACKSIZE number 


The number must be an integer; it is considered to be in decimal format by default, but C 
notation can be used to specify hexadecimal or octal format. 


EXPORTS Statement 


Summary The EXPORTS statement declares the names and attributes of the functions exported to 
other modules and the functions that run with I/O privilege. The EXPORTS statement also 
declares Windows callback functions such as dialog boxes and timer functions. It is unnec- 
essary to export callback functions within an OS/2 Presentation Manager program. 
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Syntax EXPORTS entryname [[=internalname] [@ord[RESIDENTNAME] J] [pwords] 
[[NODATA]| 


The EXPORTS keyword marks the beginning of the export definitions. It can be followed 
by up to 3,072 export definitions, each on a separate line. 


The optional keyword NODATA is ignored by OS/2, but is provided for use by real-mode 
Windows. It means there is no static data in the function. 


Fields entryname Defines the function name as known to other modules. 


internalname Defines the actual export function name as it appears within 
the module. Default is the same as entryname. 


ord Defines the function’s ordinal position within the module- 
definition table. Can contain the optional keyword 
RESIDENTNAME, which specifies that the function name 
be kept resident in memory at all times. 


pwords Specifies the total size of the function’s parameters in words. 
IMPORTS Statement 
Summary The IMPORTS statement defines the names of the functions to be imported for the applica- 


tion or library. 


Syntax IMPORTS [internalname=]|modulename.entry 


The IMPORTS keyword marks the beginning of the import definitions. This keyword is 
followed by one or more import definitions, each on a separate line. Note that if you 
supply an import library, you need not list the individual functions. 


Fields internalname Specifies the name that the importing module actually uses to 
call the function. By default, internalname is the same as the 
name given in entry. 


modulename Name of the application or library containing the function. 


entry Determines the function to be imported and can be a name or 
an ordinal value. 
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STUB Statement 


summary The STUB statement adds a DOS executable file to the beginning of the application or li- 
brary being created. Typically, the stub displays a message and terminates execution. 


Syntax STUB ‘filename’ 


The filename specifies the DOS executable file to be added. If the linker does not find 
filename in the current directory, it searches in the list of directories specified in the PATH 


environment variable. 
HEAPSIZE Statement 
summary The HEAPSIZE statement defines the size of the application’s local heap in bytes. This 


value affects the size of the automatic data segment. 


Syntax HEAPSIZE {bytes | MAXVAL} 


The bytes field is a decimal integer value by default. However, hexadecimal and octal 
numbers can be entered by using C notation. MAXVAL is an optional keyword which 
can be substituted for bytes to set the field parameter. MAXVAL sets the heap size to 
64K minus the size of DGROUP. 


PROTMODE Statement 


Summary The optional PROTMODE statement specifies that the module runs only in protected mode 
and not in Windows or dual mode. 


Syntax PROTMODE 

OLD Statement 

Summary The OLD statement directs the linker to search another dynamic-link module for export 
ordinals. 


Syntax OLD ‘filename’ 
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REALMODE Statement 
Summary The REALMODE statement specifies that the application runs only in real mode. 


Syntax REALMODE 


EXETYPE Statement 


Summary The optional EXETYPE statement specifies in which operating system the application (or 
dynamic-link library) is to run. 


syntax EXETYPE [ OS2 | WINDOWS | UNKNOWN | 
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43 
summary The NMAKE utility automates the process of compiling and linking project files. NMAKE 
is upwardly compatible with the older MAKE utility if the /MAKE option is used. 
Syntax NMAKE [loptions]] [macrodefinitions] {[targets]| 
Options [A Executes commands to build all the targets requested even if 
they are not out-of-date. 
IC Suppresses the NMAKE copyright message and prevents non- 
fatal error or warning messages from being displayed. 
/D Displays the modification date of each file when the date is 
checked. 
/E Causes environment variables to override macro definitions 
within description files. 
/F filename Specifies filename as the name of the description file to use. If 
a dash (—) is entered instead of a file name, NMAKE accepts 
input from the standard input device instead of using a descrip- 
tion file. If /F is not specified, NUAKE uses MAKEFILE as 
the description file. 
/HELP Calls the QuickHelp utility. If the QuickHelp program is not 
available, NMAKE displays the most commonly used 
NMAKE options to the standard output. 
/I Ignores exit codes (also called return or error codes) returned 
by programs called from the NMAKE description file. 
NMAKE continues executing the rest of the description file 
despite the errors. 
/N Displays the commands from the description file that 
NMAKE would execute, but does not execute these com- 
mands. This option is useful for checking which targets are 
out-of-date and for debugging description files. 
/NOLOGO Suppresses the sign-on banner when NMAKE executes. 
/P Prints all macro definitions and target descriptions. 
/Q Returns a zero exit code if the target is up-to-date and a non- 
zero exit code if it is not. This option is useful when invoking 
NMAKE from within a batch file. 
/R Ignores inference rules and macros contained in the 
TOOLS.INI file. 
IS Suppresses display of commands as they are executed. 
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/T 


/X filename 


IZ, 
/? 


NMAKE Macro Statements 


Description Block Format 


Changes the modification dates for outdated target files to the 
current date. The file contents are not modified. 


Sends all error output to filename, which can be either a file or 
a device. If a dash is entered instead of a file name, the error 
output is sent to the standard output device. 


Internal option for use by the Programmer’s WorkBench. 


Displays a brief summary of NMAKE syntax and exits to the 
operating system. 


Syntax target...: [[dependent]] [|[;command]] [#comment] 


[[command]| 
[#comment]| 


[#comment]] | [command] 


The following symbols are used in description blocks: 


Symbol 


Command Modifiers 


Meaning 
Introduces comment field 


DOS wild-card characters; NMAKE expands them in target 
names when it reads the description file 


Introduces any escape character in a description file, includ- 
ing these: #()$4\{}!@ 


These characters can be placed in front of a command to modify its effect. The character 
must be preceded by at least one space. 
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Character Action 
— Turns off error checking for the command 
@ Prevents NMAKE from displaying the command as it executes 
! Causes the command to be executed for each dependent file if 

the command uses one of the special macros $? or $** 

Macros 

Syntax macroname=macrostring 


The macroname can be any combination of alphanumeric characters and the underscore 
(_) character. The macrostring can be any valid string. 


Having defined the macro, use the following reference to include it in a dependency line or 
command: 


$(macroname) 
Use the following syntax to substitute text within a macro: 


$(macroname:stringl = string2) 


Specific Macro Names 


The following macro names have specific meanings: 


Macro Meaning 

$* The target’s base name with the extension deleted. 

$@ The full name of the current target. 

Se* The complete list of dependent files. 

$< The dependent file that is out-of-date with respect to the target 
(evaluated only for inference rules). 

$? The list of dependents that are out-of-date with respect to the 
target. 

$$@ The target that NMAKE is currently evaluating. A dynamic de- 


pendency parameter used only in dependency lines. 
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Syntax 


$(CC) 


$(AS) 


$(MAKE) 


$(MAKEDIR) 
$(MAKEFLAGS) 


Inference Rules 


The command to invoke the C compiler. By default, NMUAKE 
predefines this macro as CC = cl. 


The command that invokes the Microsoft Macro Assembler. 
NMAKE predefines this macro as AS = masm. 


The name with which NMAKE is invoked. Used to invoke 
NMAKE recursively. It causes the line on which it appears to 
be executed even if the /N option is on. Redefine this macro if 
you want to execute another program. 


The directory from which NMAKE was invoked. 


The NMAKE options currently in effect. If you invoke 
NMAKE recursively, use the command $(MAKE) 
$(MAKEFLAGS). You cannot redefine this macro. 


Inference rules are templates that NMAKE uses to generate files with a given extension. 


. fromext.toext: command |[[command] ... 


NMAKE uses these predefined inference rules: 


Inference Rule 


.C.OBJ 
.C.EXE 
-ASM.OBJ 


Directives 


Command Default Action 


$(CC) $(CFLAGS) /C $*.C CL /C $*.C 
$(CC) $(CFLAGS) $*.C CL $*.C 
$(AS) $(AFLAGS) $*; MASM $*; 


The following directives conditionally execute commands, display error messages, include 
the contents of other files, and turn on or off some of NMVAKE’s options. 
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Directive 


IF expression 


{ELSE 


{ENDIF 


'TEDEF macroname 


IIENDEF macroname 


TUNDEF macroname 


YERROR text 


Description 


Executes the statements between the !IF 
keyword and the next [ELSE or ENDIF 
directive if expression evaluates to a non- 
zero value. The expression consists of in- 
teger constants, string constants, or 
program invocations. Integer constants 
can use the C unary operators for numeri- 
cal negation (—), one’s complement (~), 
and logical negation (!), and can also use 
the C binary operators (+, —, *, /, %, &, |, 
NOLO. ||, <> a= lS Se Se and 
SS); 


Executes the statements between the 
YELSE and !ENDIF directives if the state- 
ments preceding the [ELSE directive 
were not executed. 


Marks the end of the !IF, IFDEF, or 
'TENDEF block of statements. 


Executes the statements between the 

{TF DEF keyword and the next ELSE or 
{ENDIF directive if macroname is de- 
fined in the description file. NMUAKE con- 
siders a macro with a null value to be 
defined. 


Executes the statements between the 
TTENDEF keyword and the next [ELSE 
or {ENDIF directive if macroname is not 
defined in the description file. 


Marks macroname as being undefined in 
NMAKE’s symbol table. 


Causes text to be printed, and then stops 
execution. 
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Pseudotargets 


INCLUDE filename 


!ICMDSWITCHES {+ | —}opt 


Reads and evaluates the file filename 

before continuing with the current descrip- 

tion file. If filename is enclosed by angle 

brackets (< >), NMAKE searches for the 

file in the directories specified by the gry 
INCLUDE macro; otherwise it looks in 

the current directory only. The INCLUDE 

macro is initially set to the value of the 

INCLUDE environment variable. 


Turns on or off one of four NMAKE op- 
tions: /D, /I, /N, and /S. If no options are 
specified, the options are reset to the way 
they were when NMAKE was started. 
Turn an option on by preceding it with a 
plus sign (+), or turn it off by preceding it 
with a minus sign (—). Using this directive 
updates the MAKEFLAGS macro. 


A “pseudotarget” is not a file. [tis a name that serves as a handle for building a group of 
files or executing a group of commands. The NMAKE utility includes these four pre- 
defined pseudotargets that provide special rules within a description file. 


Pseudotarget 
SILENT : 


IGNORE : 


-SSUFFLXES : extensions... 


PRECIOUS : targets... 


Action 


Does not display lines as they are ex- 
ecuted. Has same effect as invoking 
NMAKE with the /S option. 


Ignores exit codes returned by programs 
called from the description file. Has the 
same effect as invoking NMAKE with the 
/I option. 


Lists file suffixes for NMAKE to try if it 
needs to build a target file for which no de- 
pendents are specified. 


Tells NWAKE not to delete a target if the 
commands that build it are interrupted. 
Overrides the NVAKE default. ey 
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summary The Programmer’s WorkBench (PWB) provides an integrated environment for developing 
programs in C. It runs under OS/2 1.1 and DOS 3.0 and above. With PWB, you can write 
and edit source and other text files, define development projects, and build applications 
from one or more files. 


Syntax PWB [options] [[files]] 
Options The options are case sensitive. 

/D{[init]] Prevents PWB from examining initialization files, where init 

is one or more of the following characters: 

T Ignore TOOLS.INI 

S Ignore CURRENT.STS (implies P) 

P Ignore current program list 

If the /D option does not include an init character, all three 
files are ignored. 

/e cmdstr Specifies a command on start-up. The entire string of the argu- 
ment cmdstr should be placed in double quotes if it contains a 
space. 

/m mark Moves the cursor to the specified mark instead of moving it to 
the last known position. 

/r Specifies that PWB starts in read-only mode. Editing of the 
file is not permitted. 

/t ([file[[/tfile |] ]]...]] Specifies that any files that follow are temporary. If a single 
file is specified, the editor attempts to load it. If multiple files 
are specified, the first file is loaded. When the Exit function is 
invoked, the editor saves the current file and loads the next 
file in the list. 

res Lists the command-line options available for starting PWB. 

Arguments to PWB Functions 

Arg Introduces an argument or function. Type ALT+A. 

Meta Modifies the actions of a function. Type F9. 

Textarg A text argument. Type arg, then the text to be passed to the 


PWB function. 
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Numarg A text argument consisting of characters in the range 0-9. 

Markarg A text argument holding the name of a bookmark defined by 
the Mark function. 

Linearg When PWB is in line mode, entire lines of text are manipu- 


lated (deleted, moved, and so on). To select a range of lines, 
hold down the SHIFT key while moving the cursor. 


Streamarg When PWB is in stream mode, the text is treated as a stream 
of characters. Any stream of characters can be manipulated. 
Boxarg When PWB is in box mode, columns of text (boxes) can be 
| manipulated. 
Categories of PWB Functions 
Command Manipulation 
Function Default Description 
Cancel ESC Cancels the current operation 
Graphic Most Keys Inserts the ASCII value of the key into the file 
Lastselect CTRL+U Recalls the last cursor-movement argument 
Lasttext CTRL+O Recalls the last textarg entered 
Quote CTRL+P Treats the next keystroke literally 
Repeat — Repeats the previous command 
Undo ALT+BKSP Reverses the effect of the last editing change 
File Operation 
Function Default Description 
Exit F8 Exits the editor, with or without saving 
Noedit — Toggles the no-edit restriction 
Refresh SHIFT+F7 Rereads the file, discarding edits 
Saveall = Saves all modified files en! 
Setfile F2 Saves the current file or loads a new file 


of 


Cursor Movement 


Function 


Backtab 
Begfile 
Begline 


Down 
Endfile 
Endline 


Home 


Left 
Mpage 
Mpara 
Mword 
Newline 
Ppage 
Ppara 
Pword 
Right 
Tab 

Up 


Mark/Goto Position 


Function 


Mark 


Restcur 


Savecur 


Default 


SHIFT+TAB 
CTRL+HOME 
HOME 


DOWN 
CTRL+END 
END 


NUM 5 


LEFT 
PGUP 


CTRL+LEFT 


PGDN 


CTRL+RIGHT 
RIGHT 

TAB 

UP 


Default 


CTRL+M 
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Description 


Moves the cursor left to the previous tab stop 
Moves the cursor to the beginning of file 


Moves the cursor left to the beginning of 
the line 


Moves the cursor down one line 
Moves the cursor to the end of the file 


Moves the cursor to the right of the last charac- 
ter of the line 


Moves the cursor to the upper-left corner of 
the window 


Moves the cursor left by one character 
Moves the cursor back by one page 
Moves the cursor back by paragraphs 
Moves the cursor back by words 

Moves the cursor down to the next line 
Moves the cursor forward by one page 
Moves the cursor forward by paragraphs 
Moves the cursor forward by words 
Moves the cursor right by one character 
Moves the cursor right to the next tab stop 


Moves the cursor up one line 


Description 


Moves the cursor to the specified position in 
the file 


Restores the cursor position saved with 
Savecur 


Saves the cursor position for use with Restcur 
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Windows 

Function Default Description 

Maximize CTRL+F10 Expands the window to its maximum size 

Mlines CTRL+W Moves the window back by lines 

Plines CTRL+Z Moves the window forward by lines 

Resize CTRL+F8 Enlarges or shrinks the active window 

Setwindow CTRL+] Redisplays the window 

Window F6 Creates, removes, or moves between windows 

Search/Replace 

Function Default Description 

Megrep — Searches a series of files 

Mreplace — Replaces throughout a series of files 

Msearch F4 Searches backward 

Psearch F3 Searches forward 

Qreplace CTRL+\ Replaces with confirmation 

Replace CTRL+L Replaces without confirmation 

Searchall —- Highlights all occurrences of a string 

Special Insert 

Function Default Description 

Curdate — Inserts the current date (example: 28-Nov- 
1990) 

Curday — Inserts the current day (example: Sun) 

Curfile — Inserts the name of the current file 

Curfileext — Inserts the extension of the current file 

Curfilenam — Inserts the base name of the current file 


Curtime — Inserts the current time (example: 13:45:55) 


Insert/Delete 


Function 


Cdelete 


Copy 
Delete 


Emacscdel 


Emacsnewl 
Insert 
Insertmode 
Ldelete 
Linsert 
Paste 
Sdelete 


Sinsert 


Programming 


Function 


Compile 
Nextmsg 
Pbal 


Default 


CTRL+G 


CTRL+INS 
DEL 
BKSP 


ENTER 
INS 
CTRL+Y 
CTRL+N 
SHIFT+INS 


CTRL+J 


Default 


CTRL+F3 
SHIFT+F3 
CTRL+[ 
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Description 


Deletes the character to the left, excluding line 


breaks 
Copies the lines to the Clipboard 
Deletes the highlighted area 


Deletes the character to the left, including line 


breaks 

Starts a new line, breaking the current line 
Inserts spaces into the highlighted area 
Toggles insert mode on and off 

Deletes lines to the Clipboard 

Inserts blank lines 

Inserts text from the Clipboard 


Deletes a stream of text, including the line 
breaks 


Inserts blanks, breaking lines if necessary 


Description 


Executes the compile or build command 
Moves the cursor to the next error message 


Balances the parentheses and the brackets 
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Macro Creation 


Function 


Assign 
Execute 
Message 
Record 
Tell 


Usercmd 


Help 


Function 


Pwbhelp 
Pwbhelpnext 


Sethelp 


Miscellaneous 


Function 


Environment 
Information 
Initialize 
Print 

Shell 


Default 


ALT+= 
F7 


SHIFT+CTRL+R 
CTRL+T 


Default 


CTRL+F1 


SHIFT+CTRL+S 


Default 


SHIFT+F10 
SHIFT+F8 


SHIFT+F9 


04 


Description 


Defines macros and sets switches 

Executes a series of editor or macro commands 
Displays a message on the dialog line 

Turns macro recording on or off 

Displays an assignment or macro definition 


Executes a command added to the PWB 
Run menu 


Description 


Displays Microsoft Advisor help screens 


Displays the next physical topic in Microsoft 
Advisor 


Adds or deletes single help files 


Description 


Displays or modifies environment settings 
Displays a list of previously edited files 
Rereads the initialization file 

Prints all or part of a file 


Spawns a command-line shell 
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PWB Functions 


Programmer’s WorkBench 


The PWB functions and the syntax for each are listed alphabetically below. Default key- 


strokes, if available, are given in parentheses. 


Function 
(Default) 


Arg 
(ALT+A) 


Assign 
(ALT+=) 


Backtab 
(SHIFT+TAB) 


Begfile 
(CTRL+HOME) 
Begline 
(HOME) 


Cancel 
(ESC) 


Syntax 


Arg 


Assign 


Arg Assign 


Arg boxarg Assign 


Arg linearg Assign 


Arg textarg Assign 
Arg ? Assign 


Backtab 


Begfile 
Begline 
Meta Begline 


Cancel 


Description 


Introduces a function or an argument for a 
function. 


Treats the entire line (except for the line 
break) on which the cursor is positioned as 
a function assignment or macro definition. 


Treats the text from the initial cursor posi- 
tion to the end of the line (not including the 
line break) as a function assignment or 
macro definition. 


Treats each line of the boxarg as an in- 
dividual function assignment or macro 
definition. Ignores blank lines and 
comment lines. 


Treats each line as a separate function as- 
signment or macro definition, ignoring 
blank lines and comment lines. 


Treats textarg as a function assignment or 
macro definition. 


Displays the current function assignments 
for all functions and macros. 


Moves the cursor to the previous tab stop. 
Tab stops are defined to be every nth charac- 
ter, where 7 is defined by the tabstops 
switch. 


Places the cursor at the beginning of the file. 


Places the cursor on the first nonblank char- 
acter on the line. 


Places the cursor in the first character posi- 
tion of the line. 


Cancels the current operation. If an opera- 
tion is in progress, it is canceled. If there is 
no operation, but a message is on the dialog 
line, the dialog line is restored. If the help 
window is open, this function closes it. 
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Function 
(Default) 


Syntax 


Description 


Cdelete 
(CTRL+G) 


Compile 
(CTRL+F3) 


Copy 
(CTRL+INS) 


Cdelete 


Compile 


Arg Compile 


Arg textarg Compile 


Arg Arg textarg Compile 


Arg Meta Compile 


Copy 


Arg Copy 


Arg boxarg Copy 
Arg linearg Copy 
Arg streamarg Copy 
Arg textarg Copy 


Arg markarg Copy 


Deletes the previous character, excluding 
line breaks. If the cursor is in column 1, 
Cdelete moves the cursor to the end of the 
previous line. If issued in insert mode, 
Cdelete deletes the previous character, 
reducing the length of the line by 1; other- 
wise, it deletes the previous character and 
replaces it with a blank. If the cursor is 
beyond the end of the line when the func- 
tion is invoked, the cursor is moved to the 
immediate right of the last character on 
the line. 


Displays the status of the current compila- 
tion (if any) on the dialog line. 


Compiles and links the current file. Uses 
the extmake command line that matches 
the file-name extension of the current file. 


Uses the command line specified by 
extmake:text. The textarg replaces %s in 
the command line. 


Invokes the specified text as a program. As- 
sumed to display its errors in the format 
file row column message. 


OS/2 only. Halts a protected-mode compila- 
tion running in the background after 
prompting for confirmation. 


Copies the current line to the Clipboard. 


Copies text from the initial cursor position 
to the end of the line and places it in the 
Clipboard. Ignores the line break. 


Copies the highlighted text to the Clipboard. 


Copies the range of text between the cursor 
and the location of the file marker to the 
Clipboard. In stream mode, a stream of text 
is selected. In box mode, the text is treated 
as a boxarg or linearg, depending on the 
relative positions of the initial cursor posi- 
tion and the file marker. In line mode, the 
lines between the cursor and the file marker 
are copied. 
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Function Syntax Description 
(Default) 
Copy (continued) Arg numarg Copy Copies the specified number of lines to the 
Clipboard, starting with the current line. 
Curdate Curdate Inserts the current date at the cursor in the 
format of 28-Nov-1990. 
Curday Curday Inserts the current day at the cursor in the 
format of Sun...Sat. 
Curfile Curfile Inserts the fully qualified path name of the 
current file at the cursor. 
Curfileext Curfileext Inserts the extension of the current file at 
the cursor. 
Curfilenam Curfilenam Inserts the base name of the current file at 
the cursor. 
Curtime Curtime Inserts the current time at the cursor in the 
format of 13:45:55. 
Delete Delete Deletes the single character under the cur- 
(DEL) sor, excluding line breaks. SHIFT+DEL 
places the deleted character in the 
Clipboard. DEL deletes without copying 
to the Clipboard. 
Arg Delete Deletes all text from the current cursor posi- 
tion to the end of the line. The deleted text 
(including the line break) is placed in the 
Clipboard. This command has the effect of 
joining lines. 
Arg boxarg Delete Deletes the highlighted text. The deleted 
Arg linearg Delete text is placed in the Clipboard. 
Arg streamarg Delete 
Arg Meta Delete Performs the deletions as described above, 
Arg boxarg Meta Delete except the deleted text is not placed in the 
Arg linearg Meta Delete Clipboard. 
Arg streamarg Meta Delete 
Meta Delete Deletes the current character or current 
selection. The deleted text is not copied to 
the Clipboard. 
Down Down Moves the cursor down one line. If the cur- 
(DOWN or sor moves out of the window, the window 
CTRL+X) is adjusted downward by the number of 


lines specified by the vscroll switch. 


Meta Down Moves the cursor to the bottom of the win- 
dow without changing the column position. 


Programmer’s WorkBench 


58 


Function 
(Default) 


Emacscdel 
(BKSP) 


Emacsnewl 
(ENTER) 


Endfile 
(CTRL+END) 


Endline 
(END) 


Environment 


Syntax 


Emacscdel 


Emacsnewl 


Endfile 
Endline 


Meta Endline 


Environment 

Arg boxarg Environment 
Arg linearg Environment 
Arg textarg Environment 


Arg ? Environment 


Meta Environment 


Arg Meta Environment 


Description 


Performs similarly to Delete, except that at 
the beginning of a line while in insert 
mode, Emacscdel deletes the line break be- 
tween the current line and the previous line, 
joining the two lines together. 


Performs similarly to Newline, except that 
when in insert mode, it breaks the current 
line at the cursor position. 


Places the cursor at the end of the file. 


Moves the cursor to the immediate right of 
the last nonblank character on the line. 


Moves the cursor one character beyond the 
column corresponding to the rightmost 
edge of the window. 


Executes the current line as an environment- 
variable setting. 


Executes each highlighted line or line frag- 
ment as an environment-variable setting. 


Executes the text argument as an 
environment-variable setting. 


Displays all current environment-variable 
settings. 


Performs environment “mappings” for all 
environment variables found on the current 
line, whenever the variable appears in the 
following syntax: 


$(environment-variable) 
or 
$(environ:) 


For each such environment variable appear- 
ing on the line, PWB replaces the variable 
with the corresponding setting. 


Performs environment mappings (see de- 
scription above) for all text from the cursor 
position to the end of the line. 
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Function 
(Default) 


Environment 
(continued) 


Execute 
(F7) 


Exit 
(F8) 


Graphic 
(*) 

Home 
(Keypad 5) 


Information 
(SHIFT+F10) 


Initialize 
(SHIFT+F8) 


Syntax 


Arg linearg Meta 
Environment 

Arg boxarg Meta 
Environment 

Arg streamarg Meta 
Environment 

Execute 


Arg Execute 


Arg linearg Execute 
Arg textarg Execute 


Exit 


Meta Exit 


Arg Exit 


Arg Meta Exit 
Graphic 
Home 


Information 


Initialize 


Arg Initialize 


Description 


Performs environment mappings (see de- 
scription above) for all highlighted text. 


Executes a PWB function or macrolist. 


Treats the line from the initial cursor posi- 
tion to the end as a series of PWB 
commands, and executes them. 


Treats the specified text as PWB commands 
and executes them, following the standard 
rules of macro execution. 


Exits PWB. If the autosave switch is set 
to yes, the file in memory is automatically 
saved. If multiple files are specified on the 
command line, PWB proceeds to load the 
next file. 


Performs similarly to Exit, except that the 
current file is not saved. 


Performs similarly to Exit, except that if 
multiple files are specified on the command 
line, PWB exits without advancing to the 
next file. 


Performs similarly to Arg Exit, except that 
PWB does not save the current file. 


Inserts the ASCII value of the specified key 
into the file. 


Places the cursor in the upper left corner of 
the current window. 


Loads an information file that contains a list 
of all files in memory along with the cur- 
rent set of files that you have edited. The 
size of this list is controlled by the tmpsav 
switch, which has a default value of 20. 


Reads all the editor statements from the 
[PWB] section of TOOLS.INI. 


Reads the editor statements from the 
TOOLS.INI file, using the continuous 
string of nonblank characters, starting with 
the initial cursor position as the tag name. 
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Function Syntax Description 
(Default) 
Initialize Arg textarg Initialize Reads all the editor statements from the 
(continued) [PWB-textarg] section of TOOLS.INL _ 
Insert Insert Inserts a single blank space at the current 
cursor position. 

Arg Insert Inserts a carriage return at the initial cursor 
position, splitting the line. 

Arg streamarg Insert Inserts blank spaces into the highlighted 

Arg linearg Insert area. 

Arg boxarg Insert 

Insertmode Insertmode Toggles between insert mode and overtype 

(INS or CTRL+V) mode. 

Lastselect Lastselect Recalls the last cursor-movement argument. 

(CTRL+U) This function produces the same result as re- 
turning to the last Arg position, invoking 
the Arg function, and then recreating the 
last cursor-movement argument. 

Lasttext Lasttext Recalls the last textarg. This function pro- 

(CTRL+0) duces the same result as typing arg once 
and then retyping the previous textarg. 

Ldelete Ldelete Deletes the current line and places it in the 

(CTRL+Y) Clipboard. 

Arg Ldelete Deletes text, starting with the initial cursor 
position through the end of the line, and 
places it in the Clipboard. Note that it does 
not join the current line with the next line. 

Arg boxarg Ldelete Deletes the specified text from the file and 

Arg linearg Ldelete places it in the Clipboard, treating the argu- 
ment as a linearg or boxarg regardless of 
what mode PWB is in. 

Left Left Moves the cursor one character to the left. 

(LEFT or If this results in the cursor moving out of 

CTRL+S) the window, the window is adjusted to the 
left by the number of columns specified by 
the hscroll switch. . 

Meta Left Moves the cursor to the leftmost position in 
the window on the same line. 

Linsert Linsert Inserts one blank line above the current line. 
(CTRL+N) a 

Arg Linsert Inserts or deletes blanks at the beginning of 


a line to make the first nonblank character 
appear under the cursor. 


Function 
(Default) 


Linsert 
(continued) 


Mark 
(CTRL+M) 


Maximize 
(CTRL+F10) 


Message 


Meta 
(F9) 


Merep 


Syntax 


Arg boxarg Linsert 
Arg linearg Linsert 


Mark 


Arg Mark 


Arg numarg Mark 


Arg textarg Mark 


Arg Arg textarg Mark 


Arg Arg textarg Meta Mark 


Maximize 


Meta Maximize 
Message 

Arg textarg Message 
Meta Message 

Meta 


Megrep 


Arg Mgrep 


Arg textarg Mgrep 
Arg Arg Mgrep 


Arg Arg textarg Mgrep 
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Description 


Fills the specified area with blanks, treating 
the argument as a linearg or boxarg regard- 
less of what mode PWB is in. 


Moves the cursor to the beginning of 
the file. 


Restores the cursor to its previous location. 
PWB remembers only the location prior to 
the last cursor movement. 


Moves the cursor to the beginning of the 
specified line, where numarg specifies the 
line number in the file. 


Moves the cursor to the specified file 
marker. 


Defines a file marker at the initial cursor 
position. If the markfile switch contains a 
file name for saving marks, textarg will be 
added to the file when you exit PWB. 


Deletes a marker definition. 


Expands the window to its maximum size. 


Restores the window to its original size. 
Clears the dialog line. 

Prints the text argument on the dialog line. 
Forces a screen update. 


Modifies the action of the function it is 
used with. Refer to the individual functions 
for specific information. 


Searches for the previously defined string 
or pattern. PWB searches all files listed in 
the mgreplist macro. 


Searches files for the string defined as the 
characters from the initial cursor position to 
the first blank character. 


Searches files for the specified text. 


Searches files for the regular expression de- 
fined as the characters from the initial 
cursor position to the first blank character. 


Searches files for a regular expression as de- 
fined by textarg. 
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Function 
(Default) 


Megrep 
(continued) 


Mlines 
(CTRL+W) 


Mpage 
(PGUP or 
CTRL+R) 


Mpara 


Mreplace 


Msearch 
(F4) 


Syntax 


Meta Megrep 

Arg Meta Mgrep 

Arg textarg Meta Mgrep 
Arg Arg Meta Mgrep 

Arg Arg textarg Meta Mgrep 
Mlines 

Arg Mlines 


Arg numarg Mlines 


Mpage 


Mpara 
Meta Mpara 


Mreplace 


Arg Arg Mreplace 


Msearch 


Arg Msearch 


Arg streamarg Msearch 
Arg textarg Msearch 


Arg Arg Msearch 


Description 


Performs similarly to the command form 
above, except that the value of the case 
switch is temporarily reversed. 


Moves the window back by the number of 
lines specified by the vscroll switch. 


Moves the window until the line that the 
cursor is on is at the bottom of the window. 


Moves the window back by the specified 
number of lines. 


Moves backward in the file by one window. 


Moves the cursor to the first blank line pre- 
ceding the current paragraph. 


Moves the cursor to the last previous line 
that has text. 


Performs a search-and-replace across multi- 
ple files, prompting for the search and 
replacement strings, and prompting at each 
occurrence for confirmation. This function 
searches all files listed in the mgreplist 
macro. 


Performs the same action as Mreplace, but 
uses regular-expression syntax. 


Searches backward for the previously de- 
fined string or pattern. If the string or 
pattern is found, the window is moved to 
display it and the matched string or pattern 
is highlighted. If no match is found, no cur- 
sor movement takes place and a message is 
displayed. 


Searches backward in the file for the string 
defined as the characters from the initial cur- 
sor position to the first blank character. 


Searches backward for the specified text. 


Searches backward in the file for the regu- 
lar expression defined as the characters 
from the initial cursor position to the first 
blank character. 


63 


Programmer's WorkBench 


Function Syntax Description 
(Default) 
Msearch Arg Arg textarg Msearch Searches backward for a regular expression 
(continued) as defined by textarg. 
Meta Msearch Performs similarly to the command form 
Arg Meta Msearch above, except that the value of the case 
Arg textarg Meta Msearch switch is temporarily reversed. 
Arg Arg Meta Msearch 
Arg Arg textarg Meta 
Msearch 
Mword Mword Moves the cursor to the beginning of the 
(CTRL+LEFT current word. If the cursor is not currently 
or CTRL+A) in a word or it is at the first character, it 
moves to the beginning of the previous 
word. 
Meta Mword Moves the cursor to the immediate right of 
the previous word. 
Newline Newline Moves the cursor to a new line. PWB tries 
(SHIFT+ENTER) to place the cursor in an appropriate posi- 
tion based on the type of file. If the file is a 
C program and the softer switch is set, 
PWB tries to tab forward, based on con- 
tinuation of lines and open blocks. If the 
next line is blank, PWB places the cursor 
in the column corresponding to the first 
nonblank character of the previous line. If 
neither of the above is true, PWB places 
the cursor on the first nonblank character of 
the line. 
Meta Newline Moves the cursor to column 1 of the 
next line. 
Nextmsg Nextmsg Advances to the next error message. 
(SHIFT+F3) 


Arg numarg Nextmsg 


Arg Nextmsg 


Moves forward or backward numarg error 
messages. A numarg value of 1 moves to 
the next message; a value of -1 moves back 
to the previous message. 


Moves to the next error message (within the 
current set of messages) that does not refer 
to the current file. 
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Description 


Function Syntax 
(Default) 
Nextmsg Arg Arg Nextmsg 
(continued) 

Meta Nextmsg 
Noedit Noedit 

Meta Noedit 
Paste Paste 
(SHIFT+INS) 


Arg streamarg Paste 
Arg linearg Paste 
Arg boxarg Paste 


Arg Paste 


Arg textarg Paste 


Positions the text-file cursor at the line with 
the error described in the error message at 
the current cursor position in the <compile> 
pseudofile. This message becomes the cur- 
rent error message, and the equivalent of 
Nextmsg without any arguments is ex- 
ecuted. The following Nextmsg command 
displays the next error message from the 
<compile> pseudofile. 


OS/2 only. Advance to the next “set” of 
error messages, in which a set corresponds 
to all the error messages for a single compi- 
lation. After this command is executed, the 
previous set is deleted (though you can still 
view all subsequent sets of error messages 
in the <compile> pseudofile until it is 
deleted). 


Reverses the no-edit condition, so that if 
PWB was started with the /R (read-only) op- 
tion, this command removes the no-edit 
limitation. If PWB is not in the no-edit 

State, this command disallows all editing 
commands that alter a file. 


Reverses the no-edit condition for the cur- 
rent file. 


Inserts the contents of the Clipboard above 
the current line if the contents were placed 
there in a line-oriented way, such as with 
linearg or numarg. Otherwise, inserts the 
contents of the Clipboard at the current cur- 
sor position. 


Replaces the specified text with the con- 
tents of the Clipboard. 


Inserts the text from the initial cursor posi- 
tion to the end of the line at the initial 
cursor position. 


Places the specified text in the Clipboard 
and inserts that text at the initial cursor 
position. 


Function Syntax 

(Default) 

Paste Arg Arg textarg Paste 
(continued) 


Arg Arg 'textarg Paste 


Pbhal Pbal 
(CTRL+[) 
Arg Pbal 
Meta Pbal 
Arg Meta Pbal 
Plines Plines 
(CTRL+Z) 
Arg Plines 


Arg numarg Plines 


Ppage Ppage 
(PGDN or 
CTRL+C) 
Ppara Ppara 
Meta Ppara 
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Description 


Interprets textarg as a file name and inserts 
the contents of that file into the current file 
above the current line. 


Treats the text as a DOS or OS/2 command 
and inserts its output to stdout into the cur- 
rent file at the initial cursor position. 


Scans backward through the file, balancing 
parentheses and brackets. The first un- 
balanced one is highlighted when found. If 
it is found and is not visible, PWB displays 
the matching line on the dialog line, with 
the highlighted matching character. The 
corresponding character is placed into the 
file at the current cursor position. Note that 
the search does not include the current cur- 
sor position and that the scan looks only for 
more left brackets or parentheses than right, 
not just for an unequal number. 


Performs similarly to Pbal, except that it 
scans forward in the file and looks for more 
right brackets or parentheses than left. 


Performs similarly to Pbal, except that the 
file is not updated. 


Performs similarly to Arg Pbal, except that 
the file is not updated. 


Adjusts the cursor forward by the number 
of lines specified by the vscroll switch. 


Moves the cursor downward so the line that 
the cursor is on is at the top of the window. 


Moves the cursor forward the specified 
number of lines. 


Moves forward in the file by one window. 


Moves the cursor forward one paragraph 
and places the cursor on the first line of the 
new paragraph. 


Moves the cursor to the first blank line fol- 
lowing the current paragraph. 
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Function Syntax Description 

(Default) 

Print Print Prints the current file. If the printemd 
switch is set, this function uses the system- 
level command given in the switch. 
Otherwise, the function copies output to 
LPT1. 

Arg textarg Print Prints all the files listed in the text argu- 
ment. File names should be separated with 
a space. Macro file lists are allowed. 

Arg linearg Print Prints the highlighted area. 

Arg boxarg Print 

Arg streamarg Print 

Prompt Prompt Allows macros to prompt for text 
arguments. 

Arg Prompt Uses the text from the cursor to the end of 
the line as the prompt. 

Arg textarg Prompt Uses the specified text argument as the 
prompt. 

Arg linearg Prompt Uses the selected text or the first line of the 

Arg boxarg Prompt selected area as the prompt. 

Arg streamarg Prompt 

Meta Prompt Uses the selected text or the first line of the 
selected area as the prompt and passes it to 
the next function. 

Psearch Psearch Searches forward for the previously defined 

(F3) string or pattern. If the string or pattern is 
found, the window is moved to display it 
and the matched string or pattern is 
highlighted. If it is not found, the cursor 
does not move and a message is displayed. 

Arg Psearch Searches forward in the file for the string 


Arg textarg Psearch 
Arg Arg Psearch 


defined as the characters from the initial cur- 
sor position to the first blank character. 


Searches forward for the specified text. 


Searches forward in the file for the regular 
expression defined as the characters from 
the initial cursor position to the first blank 
character. 
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Function Syntax Description 

(Default) 

Psearch Arg Arg textarg Psearch Searches forward for a regular expression 
(continued) as defined by textarg. 

Meta Psearch Performs similarly to the command form 

Arg Meta Psearch above, except that the value of the case 

Arg textarg Meta Psearch switch is temporarily reversed. 

Arg Arg Meta Psearch 

Arg Arg textarg Meta 

Psearch 
Pwhbhelp Pwbhelp Microsoft Advisor help screens. 

Arg Pwbhelp Displays help on the topic at the cursor 
position. 

Arg single-line-cursor- Displays help on the text argument 

movement Pwbhelp highlighted on the screen. 

Arg textarg Pwbhelp Displays help on the specified text 
argument. 

Meta Pwbhelp Prompts the user for a keystroke and dis- 
plays help on the function associated with 
that keystroke. For this command to work, 
the cursor cannot be resting on a help topic. 

Pwbhelpnext Pwbhelpnext Displays the next physical topic in the 
(CTRL+F1) Microsoft Advisor help system. 

Meta Pwbhelpnext Displays the previous help topic on the 
backtrace list. 

Arg Pwbhelpnext Displays the next occurrence of the current 
help topic within the Microsoft Advisor 
help system. 

Pword Pword Moves the cursor forward to the beginning 
(CTRL+RIGHT of the next word. 
or CTRL+F) 

Meta Pword Moves the cursor to the immediate right of 
the current word or, if the cursor is not ina 
word, to the right of the next word. 

QOreplace QOreplace Performs a search-and-replace, prompting 

(CTRL+\) for the search and replacement strings, and 
prompting at each occurrence for confirma- 
tion. The search begins at the cursor 
position and continues through the end of 
the file. 

Arg boxarg Qreplace Performs the search-and-replace within the 

Arg linearg Qreplace highlighted area, prompting at each occur- 


Arg streamarg Qreplace 


rence for confirmation. 
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Function Syntax Description 

(Default) 

Qreplace Arg markarg QOreplace Performs the search-and-replace between 

(continued) the cursor position and the specified file 
marker, prompting at each occurrence for 
confirmation. 

Arg numarg Qreplace Performs the search-and-replace over the 
specified number of lines, starting with the 
current line, prompting at each occurrence 
for confirmation. 

Arg Arg Qreplace Performs the same as the corresponding 

Arg Arg boxarg Oreplace command listed above, except that the 

Arg Arg linearg Oreplace search pattern is a regular expression and 

Arg Arg streamarg Qreplace the replacement pattern can select special 

Arg Arg markarg Oreplace tagged sections of the search for selective 

Arg Arg numarg Oreplace replacement. 

Quote Quote Reads one keystroke from the keyboard and 

(CTRL+P) treats it literally. 

Record Record Toggles the macro recording. When a re- 

(SHIFT+CTRL+R) cording is stopped, PWB assigns all the 
recorded commands to the default macro 
name RECORDVALUE. During the record- 
ing, the name of each command is written 
to the <record> pseudofile, which can be 
placed in a window and viewed as it is dy- 
namically updated. 

Arg textarg Record Toggles the macro recording and names the 
macro. 

Meta Record Toggles the macro recording, but no editing 
commands are executed until the recording 
is turned off. 

Arg Record Performs identically to the corresponding 

Arg Arg textarg Record command listed above, but appends editing 

Arg Arg Meta Record commands to the end of the macro. 

Refresh Refresh Asks for confirmation and then rereads the 
(SHIFT+F7) file from disk, discarding all edits since the 
file was last saved. 

Arg Refresh Asks for confirmation and then discards the 


file from memory and from the file history. 
The most recently edited previous file be- 
comes the current file. 


69 


KS pea NI TT ET EY SERS EN RO A 


Programmer’s WorkBench 


Function Syntax Description 

(Default) 

Repeat Repeat Repeats the last editing command, using 
precisely the same arguments and Meta con- 
dition used by the last command. However, 
the command is executed relative to the 
new cursor position. 

Arg numarg Repeat Performs the last editing command for the 
number of times specified by numarg. Note 
that Repeat must be assigned to a key to 
execute this command. 

Replace Replace Performs a search-and-replace without con- 

(CTRL+L) firmation, prompting for the search string 
and replacement string. The search begins 
at the cursor position and continues through 
the end of the file. 

Arg boxarg Replace Performs the search-and-replace in the. 

Arg linearg Replace highlighted area. 

Arg streamarg Replace 

Arg markarg Replace Performs the search-and-replace between 
the cursor and the specified file marker. 

Arg numarg Replace Performs the search-and-replace over the 
specified number of lines, starting with the 
current line. 

Arg Arg Replace Performs the same as the corresponding 

Arg Arg boxarg Replace command listed above, except that the 

Arg Arg linearg Replace search pattern is a regular expression and 

Arg Arg streamarg Replace the replacement pattern can select special 

Arg Arg markarg Replace tagged sections of the search for selective 

Arg Arg numarg Replace replacement. 

Resize Resize Enlarges or shrinks the active window. You 

(CTRL+F8) must have at least two windows open to use 
this function. 

Restcur Restcur Restores the cursor position saved with 
Savecur. 

Right (RIGHT or Right Moves the cursor one character to the right. 

CTRL+D) If this would move the cursor off the 
screen, the window moves right by the num- 
ber of columns specified by the hscroll 
switch. 

Meta Right Moves the cursor to the window’s rightmost 
column. 

Saveall Saveall Saves to disk all files that have been altered 


but not yet saved. 
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Function 
(Default) 


Savecur 


Sdelete 


Searchall 


Selcur 


Selmode 


Select 
(SHIFT+DOWN) 


Syntax 


Savecur 


Sdelete 


Arg Sdelete 


Arg streamarg Sdelete 


Searchall 


Arg Searchall 


Arg textarg Searchall 


Arg Arg Searchall 


Arg Arg textarg Searchall 


Meta Searchall 

Arg Meta Searchall 

Arg textarg Meta Searchall 

Arg Arg Meta Searchall 

Arg Arg textarg Meta 
Searchall 


Selcur 


Selmode 


Select 


Description 


Saves the current cursor position. Restores 
it with Restcur. 


Deletes the single character under the cur- 
sor, excluding line breaks. It does not place 
the deleted character in the Clipboard. 


Deletes from the current line at the point of 
the cursor position.The text deleted (includ- 
ing the line break) is placed in the 
Clipboard. 


Deletes the stream of text from the initial 
cursor position up to the current cursor posi- 
tion and places it in the Clipboard, 
regardless of the current selection mode. 


Highlights all occurrences of the previously 
defined string or pattern. If the string exists 
in the file, the cursor moves to the first 
occurrence. 


Highlights all occurrences of the string de- 
fined as the characters from the initial 
cursor position to the first blank character. 


Highlights all occurrences of the specified 
text. 


Highlights all occurrences of the regular ex- 
pression defined as the characters from the 
initial cursor position to the first blank 
character. 


Highlights all occurrences of a regular ex- 
pression as defined by textarg. 


Performs similarly to command above, ex- 
cept that the value of the case switch is 
temporarily reversed. 


Selects a portion of text (box, stream, or 
line) from the current cursor position to an 
anchor marked by the Savecur function. 


Toggles between stream mode, line mode, 
and box mode. 


In combination with a cursor-movement 
key, selects a box, stream, or line of text to 
be passed to another PWB function. 
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Function Syntax Description 
(Default) 
Setfile Setfile Switches to the previously edited file, 
(F2) saving to disk any changes made to the cur- 
rent file if the autosave switch is set to yes. 
Arg Setfile Switches to the file name under the cursor 
beginning at the initial cursor position. 
Arg textarg Setfile Switches to the file specified by textarg. If 
the text argument is a drive or directory, 
PWB changes the current drive or directory. 
Meta Setfile Performs similarly to the corresponding 
Arg Meta Setfile command listed above, but does not save 
Arg textarg Meta Setfile the changes made to the current file. 
Arg Arg textarg Setfile Saves the current file under the name 
specified by textarg. 
Arg Arg Setfile Saves the current file. 
Sethelp Sethelp Adds or deletes individual help files from 
(SHIFT+CTRL+S) the list of files PWB searches for on-line 
help. Unlike the helpfiles switch, which 
lists the complete set of help files to be 
used, Sethelp adds or removes individual 
files from the help-file list without affecting 
the rest of the list. Sethelp affects only the 
current PWB session. 
Arg Sethelp Adds the file name under the current cursor 
position to the list of help files searched. 
Arg streamarg Sethelp Adds the highlighted file name to the list of 
files searched. 
Arg textarg Sethelp Adds the file name specified by textarg to 
the list of help files searched. 
Arg ? Sethelp Lists all currently open help files. 
Arg Meta Sethelp Removes the file name under the current 


Arg Streamarg Meta Sethelp 


Arg textarg Meta Sethelp 


cursor position from the list of help files 
searched. 


Removes the highlighted file name from the 
list of files searched. 


Removes the file name specified as textarg 
from the list of files searched. 
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Function Syntax Description 
(Default) 
Setwindow Setwindow Redisplays the entire screen. 
(CTRL+]) 
Arg Setwindow Adjusts the window so that the initial cur- 


sor position becomes the home position 
(upper left corner). 


Meta Setwindow Redisplays the current line. 

Shell Shell Saves the current file if the autosave switch 
(SHIFT+F9) is set to yes and runs the command shell. 

Meta Shell Runs the command shell without saving the 
current file. 

Arg Shell Uses the text on the screen from the cursor 
up to the end of the line as a command to 
the shell. 

Arg boxarg Shell ‘Treats each line of either argument as a sep- 

Arg linearg Shell arate command to the shell. 

Arg textarg Shell Uses textarg as a command to the shell. 

Sinsert Sinsert Inserts a single blank space at the current 
(CTRL+J) cursor position. 

Arg Sinsert Inserts a carriage return at the initial cursor 
position, splitting the line. 

Arg streamarg Sinsert Inserts a stream of blanks between the ini- 
tial cursor position and the current cursor 
position. 

Tab Tab Moves the cursor to the next tab stop. Tab 
(TAB) stops are defined by the tabstops switch. 
Tell Tell Prompts for a keystroke, then displays the 
(CTRL+T) name of the keystroke and the function as- 
signed to it in the format function:keyname. 
Arg Tell Identical to Tell, but if the keystroke has 


a macro attached, displays 
MacroName:=MacroValue. 


Arg Arg Tell Prompts for a keystroke, then displays the 
value of the macro attached to the key. If a 
function is assigned to the key, PWB dis- 
plays the name of the function. 


Arg textarg Tell Performs like Arg Tell but obtains the 
_ macro name from a textarg rather than a 
keystroke. 
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Function 
(Default) 


Tell (continued) 


Undo 
(ALT+BKSP) 


Usercmd 


Window 
(F6) 


Winstyle 
(CTRL+F6) 


Syntax 


Meta Tell 

Arg Meta Tell 

Arg Arg Meta Tell 
Arg textarg Meta Tell 


Undo 


Meta Undo 


Up 


Meta Up 


Usercmd 


Arg numarg Usercmd 


Window 


Arg Window 


Arg Arg Window 


Meta Window 
Winstyle 


Description 


Performs the same as the command listed 
above, except PWB inserts the output into 
the file rather than on the dialog line. 


Reverses the last editing change. The 
undocount switch (default value: 10) 
sets the limit for the Undo command. 


Recalls a command previously canceled 
with Undo. This command is often called 
“redo.” 


Moves the cursor up one line. If this would 
move the cursor out of the window, the win- 
dow moves upward by the number of lines 
specified by the vscroll switch. 


Moves the cursor to the top of the window, 
retaining the column position. 


Executes a command added to the PWB 
Run menu by the user. 


Executes the given user-customized com- 
mand from the Run menu. The numarg can 
be “le. ase fe an 4’, oe or 6’. 


Moves the cursor to the next window. 


Splits the current window horizontally at 
the cursor position. All windows must con- 
tain at least five lines. 


Splits the current window vertically at the 
cursor position. All windows must contain 
at least ten columns. 


Closes the window. 


Toggles between window styles: two scroll 
bars, horizontal only, vertical only, or no 
scroll bars. 
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Return Values of PWB Functions 
The return values of PWB functions are useful in conditional macros. 
as 

Function Returns TRUE Returns FALSE 
Arg Always Never 
Assign Assignment successful Invalid assignment 
Backtab Cursor moved Cursor at left margin 
Begfile Cursor moved Cursor not moved 
Begline Cursor moved Cursor not moved 
Cancel Always Never 
Cdelete Cursor moved Cursor not moved 
Compile Compilation successfully initiated, Compilation unsuccessfully in- 

or background compilation running itiated, or background compilation 

not running 
Copy Always Never 
Curdate Date inserted Insertion would make line too long 
Curday Day inserted Insertion would make line too long 
Curfile File inserted Insertion would make line too long 
Curfileext File extension inserted Insertion would make line too long 
Curfilenam File name inserted Insertion would make line too long 
Curtime Time inserted Insertion would make line too long 
Delete Always Never 
Down Cursor moved Cursor not moved 
Emacscdel Cursor moved Cursor not moved 
Emacsnewl Always Never 
Endfile Cursor moved Cursor not moved 
Endline Cursor moved Cursor not moved 
Environment Successful set or map Syntax error or line too long 
Execute Last command successful Last command failed 
Exit No return condition No return condition 
Graphic Character inserted Insertion would make line too long 
Home Cursor moved Cursor not moved ce 
Information Always Never 
Initialize Found tagged section in TOOLS.INI Did not find tagged section in 
TOOLS.INI 

Insert Always Never 


Function 


Insertmode 


Lastselect 


Lasttext 


Ldelete . 
Left 
Linsert 
Mark 


Message 
Meta 
Merep 


Mlines 
Mpage 
Mpara 
Mreplace 
Msearch 
Mword 
Newline 
Nextmsg 
Noedit 


Paste 


Pbal 
Plines 
Ppage 
Ppara 
Print 
Psearch 
Pword 
Oreplace 
Quote 
Record 


Returns TRUE 


Insert mode turned on 
Selection re-created 


Value of function eventually 
executed 


Always 
Cursor moved 


Always 


Definition or move successful 


Always 
Meta turned on 


String found 


Movement occurred 
Movement occurred 

Cursor moved 

Replacement successful 
String found 

Cursor moved 

Always 

Message found 

File or editor in no-edit state 


Usually 


Balance successful 
Movement occurred 

Cursor moved 

Cursor moved 

Print successfully submitted 
String found 

Cursor moved 

At least one replacement 
Almost always 


Recording turned on 
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Returns FALSE 


Insert mode turned off 
Arg already selected 


Bad argument 


Never 
Cursor not moved 
Never 


Bad argument, or specified file 
marker not found 


Never 
Meta turned off 


String not found or specified, or 
search terminated by CTRL+BREAK, 
or background compilation in 
progress 


Bad argument 

Bad argument 

Cursor not moved 

Replacement failed, or was aborted 
Bad argument, or string not found 
Cursor not moved 

Never 

No more messages found 

File or editor is editable 


Tried Arg Arg filename Paste and 
file did not exist 


Bad argument, or string not found 
Bad argument, or not balanced 
Cursor not moved 

Cursor not moved 

Could not start print job 

Bad argument, or string not found 
Cursor not moved 

String not found, or invalid pattern 
Insertion would make line too long 


Recording turned off 
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PWB Switches 


Function 


Refresh 
Repeat 


Replace 


Restcur 


Right 
Saveall 
Savecur 
Sdelete 
Searchall 
Setfile 


Setwindow 
Shell 
Sinsert 
Tab 


Tell 


Undo 
Up 
Window 


Returns TRUE 


File read in or deleted 


Function repeated and returned 
TRUE 


At least one replacement 


Position previously saved with 
Savecur 


Cursor on the text of a line 
Always 

Always 

Always 

Something found 


File switch successful 


Always 
Shell successful 
Always 


Cursor moved 
Key pressed has function assigned 


Usually 
Cursor moved 


Successful split, join, or move 


Returns FALSE 


Canceled, or bad argument 


Function repeated and returned 
FALSE, or no function to repeat 


String not found, or invalid pattern 


Position not saved with Savecur 


Cursor beyond end of line 
Never 

Never 

Never 

Nothing found 


No alternate file, or current file 
needs to be saved and can’t be saved 


Never 
Bad argument, or program not found 
Never 


Cursor not moved, or program not 
found 


Key pressed has no function 
assigned 


If nothing to undo 
Cursor not moved 


Any error 


To set a numeric or text switch, invoke the Options menu Editor Settings command. 
Within the list of PWB settings, switches are followed by a colon and the current setting: 


switch:value 


where switch is the name of the switch and value is a string of digits (numeric switch) or a 
string of text (text switch). 


After modifying the switch, save the PWB settings file with the File menu Save command. 


77 Programmer’s WorkBench 


The following table lists switches, along with their type, default value, and description. 


Default 

Switch Type Value Description 

askexit Boolean No Prompts for confirmation when you 
exit from PWB. 

askrtn Boolean Yes Prompts you to press ENTER when 
returning from a Shell command. 

autosave Boolean Yes Saves the current file whenever you 
move to another. If this switch is set 
to no, contents of file buffer are 
maintained, but subsequent actions, 
such as exiting, may lose edits. 

backup Text bak Determines what happens to the old 


copy of a file when a new version is 
saved to disk. A value of none speci- 
fies that no backup operation is to 
be performed; PWB overwrites the 
old file. A value of undel specifies 
that the old file is to be moved to the 
DELETED directory so that 
UNDEL.EXE can retrieve it. A 
value of bak specifies that the file 
name of the old version of the file 
will be changed to .BAK. 


browwindow Boolean Yes Defines how PWB displays Source 
Browser information. If the switch 
is set to yes, Source Browser infor- 
mation appears in a split window. If 
the switch is set to no, Source 
Browser information overwrites the 
current window. 


build Text — Defines a command line that PWB 
uses when you invoke the Compile 
function or select Compile and 
Build options from the Options 
menu. Build switches support many 
of the same features as the NVAKE 
utility. PWB uses the build switch 
to define the following features for a 
program list (in order of appearance 
in the <assign> pseudofile): 
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Switch 


build 
(continued) 


case 


Type 


Boolean 


Default 
Value 


Description 


- NMAKE macros used in the 
program list 

- Build targets set during the current 
session 

- Build-target commands: the 
combination of commands, 
defined in other build switches, 
used to build the targets 

- NMAKE inference rules used in 
the program list 

- Commands used in build-target 
commands for release and debug 
builds 

- Files to be included in the 
program list 

- Error messages to be displayed 
if the build fails 


Generally, you do not need to set the 
build switch directly, since you can 
customize most of your compile and 
link operations by selecting com- 
mands from the Options menu. 
However, you may want to set the 
build switch directly to: 


- Compile languages that are not 
available on the Options menu 

- Use options not listed on the 
Options menu 

- Perform complicated builds 
not supported by the Options menu 


Considers case to be significant for 
search and replace operations. For 
example, if case is set to yes, the 
string Procedure is not found 
as a match for the string 
procedure. 
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Switch 


color 


dbiclick 


deflang 


defwinstyle 


doslibs 


edit 


Type 


Text 


Numeric 


Text 


Numeric 


Text 


Boolean 


Default 
Value 


Override 


Yes, unless the 
/r command- 

line option has 
been specified 
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Description 


Specifies colors for windows and 
menus. A table of each color name, 
default value, and description fol- 
lows this table. 


Sets the mouse double-click 
threshold, the maximum time 
between mouse button clicks for 
them to be considered a double- 
click. In DOS, the units are 
measured in units of 1/18 
second, under OS/2 the units 

are milliseconds. 


Defines the language and the default 
extension used for file names. 
Possible values include BASIC 

(*. BAS), C (*.C), COBOL (*.CBL), 
FORTRAN (*.FOR), Lisp (*.LSP), 
MASM or ASM (*.ASM), Pascal 
(.PAS), and NONE (*.*). 


Defines the window style and the 
presence or absence of the border 
and scroll bars. Possible values 
include: 


No border, no scroll bars 

Border, no scroll bars 

Border, vertical scroll bar only 
Border, horizontal scroll bar only 
Border, vertical and horizontal 
scroll bars 


Tells PWB whether DOS/real-mode 
libraries have been installed and, if 
so, whether they have default or ex- 
plicit names. Possible values include 
“none” (not installed), “default” (n- 
stalled with default names), or 
“override” (installed with explicit 
names). 


Allows files to be edited. When edit 
is set to no, the file cannot be 
changed. 


IN We © 
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Switch 


editreadonly 


entab 


enterinsmode 


enterselmode 


factor 


fastfunc 


Type 


Boolean 


Numeric 


Boolean 


Text 


Numeric 


Text 


Default 
Value 


Yes 


Last state of 
insert or over- 
type mode from 
previous editing 
session 


Stream mode 


Description 


Allows disk files marked as read- 
only to be edited. If the switch is set 
to no, aread-only file is marked no- 
edit in PWB. 


Controls the degree to which PWB 
converts multiple spaces to tabs 
when editing a file. A value of 0 
means tabs are not used to represent 
white space; 1 means all multiple 
spaces outside of quoted strings are 
converted; 2 means all multiple 
spaces are converted to tabs. 


Starts up PWB in insert mode in- 
stead of overtype mode, or switches 
to insert mode in the middle of an 
editing session. 


Determines the start-up selection 
mode for PWB: line, box, or stream. 


With the friction switch 
factor: %105 


means “reduce the friction by a fac- 
tor of 10% every 5 repeated 
keystrokes, ” and 


factor: -60 12 


means “reduce the friction by a con- 
stant 60 every 12 repeated 
keystrokes.” 


Enables auto-repeating for PWB 
functions. By default, the functions 
that auto-repeat are Up, Down, Left, 
Right, Mlines, Mpage, Mpara, 
Mword, Plines, Ppage, Ppara, and 
Pword. The speed at which a func- 
tion auto-repeats 1s controlled by the 
friction and factor switches. 
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Switch 


filetab 


friction 


height 


heipfiles 


helplist 


helpwindow 


Type 


Numeric 


Numeric 


Numeric 


Text 


Boolean 


Boolean 


Default 
Value 


8 


29 


$PATH: 
PWB.HLP 


Yes 


Description 


Determines how PWB translates 
tabs to spaces when reading or writ- 
ing a disk file. This switch also 
determines how PWB translates 
spaces to tabs for modified lines, 
when entab> 0. The value of the 
switch gives the number of spaces 
associated with each tab column. 
For example, the setting "filetab:4" 
assumes a tab column every four 
positions on each line. Every time 
PWB finds a tab character in a file, 
it loads the buffer with the number 
of spaces necessary to get to the 
next tab column. 


With the factor switch, controls the 
amount of repeat rate (friction) of 
the direction keys. A larger value 
means the repeat rate is slower. 


Controls the number of lines in the 
PWB editing window. This is useful 
with a nonstandard display device. 
Enhanced Graphics Adapter (EGA) 
in 43-line mode on the IBM PC uses 
a value of 43. VideoGraphics Array 
(VGA) in 50-line mode uses a value 
of 50. 


Specifies which .HLP files should 
be searched by on-line help. 


If the switch is set to yes and the 
user requests help on a topic for 
which there are several entries, 
PWB displays a list of available 
help files. If the switch is set to no 
or if there is only one help entry for 
the topic, PWB displays the first in- 
formation it finds about a given 
topic. 

Controls split-screen behavior. 
When the switch is set to no, PWB 
does not split the screen to display 
on-line help information. 
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Default 
Switch Type Value Description 


hike Numeric 4 Specifies the cursor’s new-line posi- 
tion (from the top of the screen) 
when the cursor is moved out of the 
current window by more than 
vscroll lines. 


hscroll Numeric 10 Controls the number of columns 
shifted left or right when the cursor 
is scrolled out of the editing window. 


load Text — Specifies the name of a PWB exten- 
sion executable file to be loaded. 
When this switch is assigned a new 
value, the extension file named is 
loaded into memory and initialized 
by calling its WhenLoaded 
function. 


markfile Text — Specifies the name of the file PWB 
searches when looking for a marker 
that is not in the in-memory set. 
This file can be created by entering 
lines of the following form: 


markername filename line column 


Here, line and column specify the 
position in the file filename where 
the marker markername appears. 


menukey Text ALT Defines the key that enables the 
PWB menu bat. 


msgflush Boolean Yes Determines the fate of previous com- 
piler messages when a background 
compile operation occurs. When the 
switch is set to yes, the old compiler 
messages are deleted. When it is set 
to no, the old messages can be re- 
tained. Under DOS, compiler 
messages are always cleared, be- 
cause background compiles are 
impossible. 


noise Numeric 50 Controls the number of lines 
counted at a time when searching or 
loading a file. This value is dis- 
played in the lower right corner of 
the screen or in a status box and can 
be set to no by setting noise to 0. 
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Switch 


os2libs 


printcmd 


readonly 


realtabs 


rmargin 


Savescreen 


searchwrap 


shortnames 


Type 


Text 


Text 


Text 


Boolean 


Numeric 


Boolean 


Boolean 


Boolean 


Default 
Value 


Override 


Yes 


EZ 


Yes 


Yes 


Description 


Tells PWB whether protected-mode 
libraries have been installed and, if 
so, whether they have default or ex- 
plicit names. Possible values include 
“none” (not installed), “default” (in- 
stalled with default names), or 
“override” (installed with explicit 
names). 


Specifies a system-level command 
that PWB invokes when you issue 
the Print command. 


Specifies the DOS command in- 
voked when PWB attempts to 
overwrite a read-only file. The cur- 
rent file name replaces %s. 


Preserves actual tab characters in- 
stead of converting them to spaces. 
When this switch is set to yes, PWB 
preserves tab alignment as charac- 
ters are added and deleted. 


Controls the right column margin 
used for wordwrap mode. Any char- 
acter typed to the right of this 
margin causes a line break. Word- 
wrap mode is turned on and off with 
the wordwrap switch. 


Saves and restores the DOS or OS/2 
screen (used with the Shell and Exit 
functions). 


Causes search and replace com- 
mands to wrap past the end of the 
file and continue searching from the 
beginning. Unsuccessful searches 
stop after the entire file is searched 
once. When this switch is set to no, 
searches stop at the beginning or 
end of the file. 


Allows you to load a file by giving 
only the base name, which PWB 
searches for in the <information 
file>. 


Switch 


softer 


tabalign 


tabdisp 


tabstops 


tmpsav 


traildisp 
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Type 


Boolean 


Boolean 


Numeric 


Numeric 


Numeric 


Numeric 


Default 
Value 


Yes 


32 


20 
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Description 


Attempts to indent, based upon the 
format of the surrounding text 
when you invoke the Newline or 
Emacsnewl function. 


Determines where the cursor can be 
placed in a tab field. When the 
switch is set to no, the cursor can be 
placed anywhere in a tab field. 
When the switch is set to yes (and if 
realtabs is also set to yes), the cur- 
sor aligns with the column position 
of the tab. 


Specifies the ASCII value of the 
TAB character. Normally, a space is 
used, but a graphic character can be 
used to show which spaces corre- 
spond to tabs. 


Controls the number of spaces be- 
tween each logical tab stop for the 
Tab and Backtab movement func- 
tions. This switch has no relation to 
the interpretation of actual tabs. 


Controls the maximum number of 
files about which information is 
kept between editing sessions. Each 
file is listed once. When you exit 
PWB, the positions of the cursor 
and window are saved. When you 
edit a file a second time, the screen 
is restored to its previous condition. 
If this switch is set to 0, PWB lets 
the information file grow without 
limit; all files ever edited appear 

in the information file until 
CURRENT:STS 1s altered or 
deleted. 


Specifies the ASCII value of the 
character to be displayed as trailing 
spaces. This switch has no effect 
unless the trailspace switch is set 
to yes. 
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Switch 


traillines 


traillinesdisp 


trailspace 


undelcount 


undocount 


unixre 


user 


Type 


Boolean 


Numeric 


Boolean 


Numeric 


Numeric 


Boolean 


Text 


Default 
Value 


No 


Space ASCII 32 


No 


No limit 


10 


Yes 
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Description 


If this switch is set to yes, blank 
lines at the end of the file are re- 
tained when the file is saved. If the 
Switch is set to no, PWB does not 
save any blank lines following the 
last nonblank line. 


Specifies the character displayed in 
the first column of each line beyond 
the end of a file. 


Preserves trailing spaces in each line 
you modify. 


Controls the number of backup 
copies of a file saved when the 
backup switch is set to undel. 
When the limit is exceeded, PWB 
discards the oldest backup. 


Controls the number of times you 
can undo or redo an edit function. 


Specifies the UNIX regular- 
expression syntax rather than 
the syntax used by PWB. 


Customizes the PWB Run menu by 
adding a program that can be called 
from within PWB. The user switch 
takes these parameters: 


user: title, path, arg, output, dir, 
helpline, runtime, return, backgrd, 
key 


The first two parameters are man- 
datory. Title is the name of the 
program as it appears on the menu, 
and path is the complete file 
specification. 
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Switch 


user (continued) 


viewonly 


vscroll 


width 


winlibs 


wordwrap 


Type 


Boolean 


Numeric 


Numeric 


Text 


Boolean 


Default 
Value 


Current 
directory 
None 


No 


No 
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Override 


No 


Description 


The remaining parameters are 
optional: 


arg: command-line arguments 
output: output file 
dir: working directory 


helpline: Appears on left side of 
status bar 

runtime: Determines whether PWB 
displays a run-time dialog box for 
passing arguments to the program 
return: Determines whether PWB 
is to prompt for a keystroke upon 
completion 

backgrd: Determines whether an 
OS/2 program runs in the 
background 

key: Assigns a shortcut key to this 
program (1-9) 


When set to yes, the file in memory 
can be viewed, but not edited. 


Controls the number of lines shifted 
up or down when the cursor is 
scrolled out of the editing window. 
The Mlines and Plines functions 
also use this value. 


Controls the width of the display 
mode for displays that are capable 
of showing more than 80 columns. 
Values other than 80 are supported 
only for a limited number of 
monitors. 


Tells PWB whether Windows librar- 
ies have been installed and, if so, 
whether they have default or explicit 
names. Possible values include 
“none” (not installed), “default” (in- 
stalled with default names), or 
“override” (installed with explicit 
names). 


Breaks lines of text when you edit 
them beyond the margin specified 
by rmargin. 
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Color Switch Values 


The following table lists the color names used with the color switch, along with the default 
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value and description of each. The syntax 


color:option 


1s used. 


Color Names Description Default Value 
alert MessageBox alerts 70 
border Window borders 07 
buttondown Pushed button color 07 
dialogaccel Dialog box accelerators 7£ 
dialogaccelbor Dialog box accelerator border 7f 
dialogbox Dialog box background 70 
disabled Disabled items 78 
elevator Scroll bar elevator 07 
enabled Enabled items 70 
helpbold Help boldface text If 
helpitalic Help italic text la 
helpnorm Help normal text 17 
helpunderline Help underline text Ic 
helpwarning Help warning text 70 
hilitectrl Highlighted control items 07 
info Status line without buttons 3f 
itemhilitesel One highlighted character Of 
(under selection bar) 
listbox Listbox background 70 
menu Menu bar color 70 
menubox Background for menus 70 
menuhilite One highlighted character 7£ 
menuhilitesel One highlighted character Of 
(under selection bar) 
menuselected Selected menus 07 
pushbutton Pushbutton color 70 
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Color Names Description Default Value 

scrollbar Scroll bar background and 70 
arrows 

selection Area highlighted by "Arg 71 
cursor-movement" 

shadow Shadows 08 

status Status information 70 

text Normal text color 17 

Regular Expressions 


Simple 


A “regular expression” is a special search string that matches a pattern of text rather than a 
specific sequence of characters. PWB supports two versions of regular-expression syntax: 
UNIX and Microsoft Editor version 1.0. The unixre switch controls which version is in 
effect. 


UNIX Special Characters 


The following list describes the UNIX special characters. All characters should be inter- 
preted literally, except class, which has a special meaning (defined below). 


\ Escape. Causes PWB to ignore the special meaning of the 
next character. 


Wild card. Matches any single character. 


. Beginning of line. Matches the following pattern only when it 
occurs at the beginning of a line. 


$ End of line. Matches the preceding pattern only when it oc- 
curs at the end of a line. 


[class] Character class. Matches any one character in the class. A 
dash (—) specifies a contiguous range of ASCII values. For ex- 
ample, [a-zA-Z@-9] matches any letter or digit, and 
[abc] matches a, b,or c. 
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[Aclass] Inverse of character class. Matches any character not 
specified in the class. 


Complex xX* Repeat operator. Matches zero or more occurrences of X, 
where X represents a regular expression that is either a single 
character, a group of characters enclosed in brackets ([ ]), or 
the regular-expression delimiters ’\ (’ and ’\ )’. This operator 
always matches as many characters as possible. 


Vea) Tagged expression. A marked substring that you can refer to 
elsewhere in the search string or in a replacement string. 
When a tagged expression is referred to in a search string, 
PWB finds text with the tagged expression repeated. When 
a tagged expression is referred to in a replacement string, 
PWB reuses part of the text it is replacing. Characters falling 
between ’\(’ and ’\)’ are treated as a group. 


\n Reference to the characters matched by a tagged expression. 
The one-digit number 7 indicates which expression. 


Non-UNIX Special Characters 


The following list describes the special characters originally used in the Microsoft Editor 
version 1.0. The term class has a special meaning (defined below). All other characters 
should be interpreted literally. 


Simple \ Escape. Causes PWB to ignore the special meaning of the 
next character. 
2 Wild card. Matches any single character. 
‘ Beginning of line. Matches the following pattern only when 


it occurs at the beginning of a line. 


$ End of line. Matches the preceding pattern only when it 
occurs at the end of a line. 


[class] Character class. Matches any one character in the class. 
A dash (—) specifies a range of values. For example, 
La-zA-Z@-9] matches any character or digit, and 
[abc] matches a, b,or c. 
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Complex 


[~class] 


xX* 


X# 


(X11X2!...1Xn) 


a4 


XAn 
ft 


$n 


letter 


Inverse of character class. Matches any character not 
specified in the class. 


Minimal matching. Matches zero or more occurrences of X, 
where X represents a regular expression that is either a single 
character or a group of characters enclosed in parentheses 
(()), brackets ([ ]), or braces ({ }). 


Minimal matching plus (shorthand for XX*). Matches one or 
more occurrences of X. 


Maximal matching. Identical to X*, except that it matches as 
many characters as it can. 


Maximal matching plus. Identical to X+, except that it 
matches as many characters as it can. 


Alternation. Matches either X/, X2, or Xn. It tries to match the 
expressions in order, and switches from Xi to Xi+J only if the 
rest of the expression fails to match. 


The not function. Matches nothing, but checks to see whether 
the string matches X at this point and fails if it does. 


Power function. Matches exactly n copies of X. 


Tagged expression, which is a string of characters you iden- 
tify so that you can refer to them elsewhere as $n. By refer- 
ring to a tagged expression in a search string, you cause PWB 
to look for patterns involving duplication. By referring to a 
tagged expression in a replacement string, you cause PWB to 
reuse part of the text that it is replacing. Characters within 
braces are treated as a group. 


Reference to a previously tagged substring. The number n in- 
dicates which substring. The first tagged substring is repre- 
sented as $1, the second as $2, and so on. The tag $0 
represents the entire matched string. 


Predefined string. See the predefined regular expressions 
listed below. 
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Predefined Regular Expressions 


Letter 


a a 


Ng¢g2s 8 


Meaning 


[a-zA-Z0-9] 

([\ t}#) 

[a-zA-Z] 

[0-9] 

CL~/WNUAENIN\: <l>t+=; ,.J#!) 
([O-9a-fA-F]#) 

({a-zA—Z_$] [a-zA—Z0-9_$]@) 
([O—-9]#.[0-9]@! [0-9 |@.[0—9 ]#![0—9]#) 
(({a—z] \: DOAN DCECE DVN @:f C:£ 9) 
CT-"T@"! "'[- "J@") 

({a-zA—Z]#) 

([O—9 }#) 


Description 


Alphanumeric 

White space 
Alphabetic 

Digit 

Portion of a file name 
Hexadecimal number 
C-language identifier 
Number 

Path 

Quoted string 

Word 


Integer 
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Summary QuickHelp is a stand-alone utility that displays help files. Specify the options in the QH en- 
vironment variable or on the command line. When QuickHelp starts, it first processes all 
options in the QH environment. It then processes any additional options on the command 
line. 


Syntax QH [[options]] topic 


Options /d filename Specifies either a specific database name or a path where the 
databases are found. If filename is specified, then that data- 
base is loaded. If a path is specified, all files with the exten- 
sion .HLP are loaded. 


Instead of a path, you can specify an environment variable by 
preceding it with a dollar sign and following it with a colon; 
for example, /d $INCLUDE:*.HLP. 


/Inumber Specifies the number of lines the QuickHelp window should 
occupy. If you specify more lines than the current screen 
mode allows, QuickHelp uses the maximum number allowed 
by the current screen mode. 


/mnumber Changes the screen mode to display the specified number of 
lines, where number is in the range 25-50. 


/p filename Sets the name of the paste file. This option must be followed 
by a fully qualified file name. This option acts in the same 
way as the Rename Paste File command on the File menu. 
The default paste file is PASTE.QH, and the file is placed in 
the TMP directory. 


/pa [filename || Specifies that pasting operations are to be appended to the cur- 
rent paste file (rather than overwriting the file). You can fol- 
low this option with the name of a file if you do not want 
paste operations to go to the default file PASTE.QH in the 
TMP directory. 


/q Prevents the version box from being displayed when Quick- 
Help is installed as a keyboard monitor. 
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QuickHelp 


/t command 


/s 


Specifies the command that QuickHelp should execute when 
the Right mouse button is pressed. The default action is to 
simulate double-clicking the Left mouse button. In other 
words, single-clicking the Right mouse button is identical to 
double-clicking the Left mouse button. The following com- 
mands are available to change this behavior: 


Command 


| 


Meaning 


Pressing the Right mouse button will 
display the last topic viewed. This is 
identical to the View Last command on 
the View menu. 


Pressing the Right mouse button will dis- 
play a history of the last topics viewed. 
This is identical to the View History com- 
mand on the View menu. 


Pressing the Right mouse button will tem- 
porarily hide the QuickHelp window, allow- 
ing you to select a topic from the screen 
that was displayed prior to activating Quick- 
Help. This is identical to the Hide Window 
command on the View menu. 


Pressing the Right mouse button will dis- 
play the historically previous topic. This is 
identical to pressing ALT+F1. 


Pressing the Right mouse button will con- 
tinue the search for a topic—displaying the 
next topic found, if there are any additional 
topics with the same name. This is identical 
to the Continue Search command on the 
View menu. 


Pressing the Right mouse button will dis- 
play the table of contents for the current 
topic. This is identical to the Contents 
command on the View menu. 


Specifies that clicking the mouse above or below the scroll 
box causes QuickHelp to scroll by lines rather than by pages. 


QuickHelp 
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/sgnumber 


/t name 


/u 


Specifies the number of screen groups that QuickHelp should 
monitor, where number is in the range 1-12. This option is 
valid only when QuickHelp is detached from an OS/2 pro- 
tected-mode screen group. The default is to monitor the first 
six screen groups created. 


Directs QuickHelp to copy the specified section of the given 
topic to the current paste file. This option must be followed by 
a section name. If the paste-file mode is Append (/pa), Quick- 
Help displays the specified topic in the window. If the paste- 
file mode is Overwrite (/p), QuickHelp exits immediately 
after copying the section to the paste file. The following lists 
the possible topic sections: 


Topic Description 

All Specifies the entire topic 

Syntax Specifies the syntax section of the topic 
Example Specifies the example of the topic 


When this option is specified, QuickHelp does not display its 
window. Instead, it searches for the topic specified on the com- 
mand line, pastes the topic to the paste file, and exits. This 
command is normally used only with DOS editors that spawn 
a shell to QuickHelp to get the paste file. This option is ig- 
nored if QuickHelp is installed as a keyboard monitor. 


Specifies that QuickHelp is being run by a utility. If the topic 
specified on the command line is not found, QuickHelp imme- 
diately exits with an exit mode of 3. 
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summary RM moves a file to the DELETED directory. You can use the UNDEL command to re- 
cover the file. 


Syntax RM [options] files 
Options Options can be grouped. 
/f Deletes read-only files without prompting. 
/help Displays the help file you are reading. 
hi Inquires for user permission before removing. 
/k. Keeps read-only files without prompting. 
/r Recurses into subdirectories. A subdirectory to recurse into 


must be specified. If one is not specified, RM interprets the 
file name as the name of the subdirectory. 
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Summary UNDEL undeletes a deleted file by moving it from the DELETED subdirectory to the 
parent directory. 


Syntax UNDEL |[/HELP] [filename] 
The /HELP option causes UNDEL to attempt to call the QuickHelp program. 


If filename is not given, the contents of the DELETED subdirectory are listed. If there 

is more than one version of the file, you are given a list to choose from. If another copy 
of the deleted file exists in the parent directory, the current version is moved to the 
DELETED directory and the previously deleted version is moved to the parent directory. 
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Keywords 
Keywords preceded by an underscore (_) are specific to Microsoft C. 
_asm do for _pascal static 
auto double _fortran register struct 
_based else goto return switch 
break _emit _huge _Saveregs typedef 
case enum if _segment union 
_cdecl _export int _segname unsigned 
char extern _interrupt _ self void 
const _far _loadds short volatile 
continue _fastcall long signed while 
default float _hear sizeof 
Statements 


AC statement consists of program-control keywords, expressions, and function calls. All 
single statements end with a semicolon. In the following list, statement can be either a 
single statement ending with a semicolon or a block of statements enclosed in braces. 


Statement 


break; 
continue; 


do 
statement 
while( expression ); 


for( [[initexpr]]; 
[condition]; 


[Joopexpr] ) 
statement 


goto name; 


name: Statement 


Action 


Terminates the smallest enclosing do, for, switch, or while 
statement in which it appears. 


Passes control to the next iteration of the smallest enclosing 
do, for, or while statement in which it appears. 


Executes statement repeatedly until expression becomes false 
(0). The statement always executes at least once because the 
exit condition is tested at the end of the loop. 


Executes statement repeatedly. First the initializing expression 
initexpr is evaluated (separate multiple initializing expres- 
sions with commas). Then while condition evaluates to a non- 
zero value, statement is executed and loopexpr is evaluated. 
When condition becomes 0, control passes to the statement 
following the for loop. 


Transfers control directly to the statement specified by the | 
label name. The label name must be in the same function as 
the goto statement. 
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if( expression ) 
statementl 

[else 
statement2 |] 


return [[expression]]; 


switch( expression ) 


[case constexpr:]] 
[[statement]] 


[default : 
statement]| 
} 


while( expression ) 
statement 


Escape Sequences 


\a 
\b 
\f 
\n 
\r 
\t 


\v 
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Executes statement if expression 1s true (nonzero). If 
expression 1s false and an else is present, control passes to 
statement2. 


Empty statement; has no effect. 


‘Terminates execution of the function in which it appears and 
returns control and the value of expression to the calling 
function. 


Evaluates expression and executes any statement associated 
with the constant expression constexpr whose value matches 
the initial expression. All statements following case are ex- 
ecuted until a break is encountered or the switch block ends. 
If there is no match with a constant expression, the statement 
associated with the default keyword is executed. If the 
default keyword is not used, control passes to the statement 
following the switch block. 


Executes statement repeatedly until expression becomes 0. 
The exit condition is tested on entry. If expression is initially 
false, statement never executes. 


Alert (bell) 
Backspace 
Form feed 
Newline 
Carriage return 
Horizontal tab 


Vertical tab 
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v Single quotation mark 
sas Double quotation mark 
\\ Backslash 
\Oddd ASCII character in octal notation 
\xdd ASCII character in hexadecimal notation 
Operators 
C operators have two properties: precedence and associativity. Within a given level, all 
operators have the same precedence. 
Operator Name or Meaning Associativity 
Highest Precedence () Function call Left to right 
[] Array element 


Member selection 

(structure or union) 
—> Member selection 

(pointer to structure) 


++ Increment Right to left 
—— Decrement 

> Base operator Left to right 
! Logical NOT Right to left 
~ Bitwise complement 

— Arithmetic negation 

+ Unary plus 

& Address 

. Indirection 

sizeof Size in bytes 

(type) Type cast 

* Multiplication Left to right 
/ Division 

% Remainder 

+ Addition Left to right 
- Subtraction 

<< Left shift Left to right 


>> Right shift 
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Lowest Precedence 


Data Type Sizes 


Operator 


el ?e2:e3 


Name or Meaning Associativity 


Less than Left to night 
Less than or equal to 

Greater than 

Greater than or equal to 


Equality Left to nght 
Inequality 

Bitwise AND Left to right 
Bitwise exclusive OR Left to right 
Bitwise inclusive OR Left to right 
Logical AND Left to right 
Logical OR Left to right 
Conditional Right to left 


Simple assignment Right to left 
Multiplication assignment | 
Division assignment 

Modulus assignment 

Addition assignment 

Subtraction assignment 

Left-shift assignment 

Right-shift assignment 

Bitwise-AND assignment 
Bitwise-exclusive-OR 

assignment 

Bitwise-inclusive-OR 

assignment 


Comma Left to nght 


The /J command-line option makes the char default to unsigned instead of signed. Any in- 
tegral type that can be modified by the unsigned keyword can also be modified by signed, 
which is most useful when the /J option is in effect. 


Type Name 


char 


unsigned char 
int 


short 


unsigned short 


long 
unsigned long 
_segment 


enum 
float 


double 


long double 


Preprocessor Directives 


#define id sub 
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Alternative Storage Range of Values 

Names 

signed char 1 byte —128 to 127 

— 1 byte 0 to 255 

signed, signed int 2 bytes —32,768 to 32,767 

short int, signed 2 bytes —32,768 to 32,767 

short, signed 

short int 

unsigned short int 2 bytes 0 to 65,535 

long int, signed 4 bytes —2,147,483,648 to 

long, signed long 2,147,483,647 

int 

unsigned long int 4 bytes 0 to 4,294,967,295 

— 2 bytes 0 to 65,535 

— 2 bytes —32,768 to 32,767 

— 4 bytes Approximately 
1.2E-38 to 
3. 4E+38 (7-digit 
precision) 

oa 8 bytes Approximately 
2.2E-308 to 


1.8E+308 (15- 
digit precision) 


— 10 bytes Approximately 
1.2E+4932 to 
3. 4E-4932 (19- 
digit precision) 


Defines a text-substitution macro or a function macro. All sub- 


#define id(param) sub sequent cases of the identifier id are replaced by the substitu- 


tion text sub. If a parenthesized parameter list param follows 
id, each occurrence of id(param) is replaced with a version of 
sub modified by substituting actual arguments for formal 
parameters. 
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f#undef identifier 


#error message 


#include "path-spec" 
#include <path-spec> 


#if expression 
[[text]] 

#elif expression 
text] 


[[#else 
text] 
#endif 


Hifdef id 
#if defined (id) 


Hendif 


#line constant 
[["name "T 


#pragma directive 


Preprocessor Operators 


#operand 
tokenl##token2 


#@ parameter 
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Removes (undefines) the current definition of identifier. 


Displays a diagnostic message on the standard error and re- 
turns a nonzero (error) code when the compiler terminates. 


Treats the contents of the file specified by path-spec as if it 
were part of the current file. If path-spec is enclosed in double 
quotation marks, the current directory is searched first, fol- 
lowed by any other directories in the path. If path-spec is en- 
closed in angle brackets, the standard include directory 
(defined by the environment variable INCLUDE) is searched 
first. 


Checks each expression associated with a #if or #elif directive 
until a nonzero restricted constant expression is found, then 
processes the text associated with that restricted constant ex- 
pression. If there is a #else clause, the text associated with it is 
only processed if no restricted constant expression in the #if 
or #elif clauses has a nonzero value. 


Checks to see whether id is currently defined. The #ifdef 
directive processes the statements within the block if id is cur- 
rently defined, or skips ahead to the #endif if it isn’t. The 
#ifndef directive processes the statements if the definition is 
missing, or skips ahead if it is present. The #ifdef directive is 
equivalent to the ANSI-standard directive #if defined(id), and 
#ifndef is equivalent to #if !defined(id). 


Changes the compiler’s internally-stored line number to 
constant, and changes the internal file name to filename. The 
current line number and file name are available through the 
predefined identifiers LINE and FILE. 


Instructs the compiler to effect the implementation-specific 
feature indicated by directive. 


Puts quotation marks around operand, treating it as a string 
Pastes tokenl and token2 together 


Expands the argument to a quoted character 
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Pragmas 


alloc_text #pragma alloc_text ( text-segment, functionl[, function2]... ) 
Places the specified functions in the given text segment. 
check pointer #pragma check_ pointer ( [[{ on | off }]] ) 


Instructs the compiler to turn off pointer checking if off is 
specified, or turn on pointer checking if on is specified. The 
check pointer pragma only works when you compile with 
the Quick Compile (/qc) option. If check _ pointer is 
specified with no arguments, it toggles the pointer-checking 
setting currently in effect. 


check_stack #pragma check_stack ( [[{ on | off }]] ) 


Instructs the compiler to turn off stack probes if off is given, 
or turn on stack probes if on is given. If no argument is given, 
stack probes are treated according to the default (on unless 
/Gs was used). 


comment #pragma comment( commenttype [,"commentstring' ]... ) 


Directs the compiler to place a comment record in the object 
file. The parameter commenttype specifies a compiler, exestr, 
lib, or user comment record, and commentstring (enclosed in 
quotation marks) provides additional information. 


function #pragma function( function! [, functionz...]] ) 


Directs the compiler to generate function calls instead of the 
intrinsic forms for each function listed. 


intrinsic #pragma intrinsic( function! [, function2...]] ) 


Instructs the compiler to generate the intrinsic forms of the 
listed functions. 


linesize #pragma linesize( [characters] ) 
Sets the number of characters per line in the source listing. 
loop_opt #pragma loop opt( [[{ off! on }]] ) 


Turns loop optimizing on or off. Without an argument, the 
pragma directs the compiler to revert to the behavior specified 
on the command line. 
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message 


optimize 


pack 


page 


pagesize 


#pragma message( messagestring ) 


Sends a message to the standard output. The messagestring 
parameter is a string literal that contains the message. 


#pragma optimize("[[o_string]|" { off! on } ) 


Enables or disables one or more optimizing options. The op- 
tional o_ string list can include one or more of the following 
characters: 


a Assume no aliases in the following code 

C Enable local common subexpressions 

e Enable global register allocation 

g Enable global common subexpressions 

J Optimize loops 

n Disable unsafe loop optimizations 

p Ensure floating-point consistency 

t Optimize for speed 

WwW Assume no aliases except across function 
calls 


If the list is empty, the compiler reverts to the default settings. 
If on or off is omitted, the given option is toggled. 


#pragma pack( [[number]] ) 


Specifies packing alignment for struct types, where number is 
1, 2, or 4. Without an argument, packing reverts to the be- 
havior specified on the command line. The /Zp option without 
number is equivalent to #pragma pack(1). In the absence of 
the /Zp option, the default is #pragma pack(2). 


#pragma page( [pages] ) 


Directs the compiler to skip the specified number of pages in 
the source listing where the pragma appears. 


#pragma pagesize( [[lines]] ) 


Sets the number of lines per page in the source listing. 
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same_ seg 


skip 


subtitle 


title 


#pragma same_seg( variablel[[, variable2]... ) 


Directs the compiler to assume that the external far variables 
are allocated in the same segment. The /ND option must be 
used when compiling the modules containing the listed varia- 
bles to ensure that these variables are actually allocated in the 
given data segment. 


#pragma skip( [lines] ) 


Skips specified number of Jines and generates a newline in the 
source listing at the point where the pragma appears. 


#pragma subtitle( "subtitlename" ) 
Sets a subtitle in the source listing. 
#pragma title( "titlename" ) 


Sets the title for the source listing. It appears in the upper left 
corner of each page of the listing. 
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Routines by Category 


The Microsoft C run-time library contains approximately 500 routines useful for 
performing common programming tasks. In this part of the C Reference the 
routines are listed first by category of tasks and then alphabetically. 


The alphabetical listing is more complete. It gives the following information for 
each routine: the prototype, the header files that contain the routine, a definition 
of each argument, the return value, and a brief description of the function the 
routine performs. In addition, check boxes indicate whether the routine is ANSI- 
compatible and the operating systems it works under. | 


This section lists and briefly describes the library routines according to the cate- 
gories of tasks they perform. These are the main categories of library routines: 


Buffer manipulation Memory allocation 

Character classification and Process and environment 
conversion control 

Data conversion | Searching and sorting 
Directory control String manipulation 

File handling System calls 

Graphics input and output Time | 

Internationalization Variable-length argument lists 
Math 
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Buffer Manipulation 
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The buffer-manipulation routines are useful for working with areas of memory 
on a character-by-character basis. Routines preceded by the _f prefix are model- 


independent versions. 


Routine 


memccpy, fmemecpy 


memchr, fmemchr 


memcmp, fmemcmp 
memcpy, fmemcpy 


memicmp, 
_fmemicmp 


memmove, 
_fmemmove 


memset, fmemset 


swab 


Use 


Copies characters from one buffer to another, until a 
given character or a given number of characters has 
been copied 


Returns a pointer to the first occurrence, within a 
specified number of characters, of a given character 
in the buffer 


Compares a specified number of characters from 
two buffers 


Copies a specified number of characters from one 
buffer to another 


Compares a specified number of characters from 
two buffers without regard to the case of the letters 
(uppercase and lowercase treated as equivalent) 


Copies a specified number of characters from one 
buffer to another 


Uses a given character to initialize a specified num- 
ber of bytes in the buffer 


Swaps bytes of data and stores them at the specified 
location 


Character Classification and Conversion 


The character classification and conversion routines let you test individual char- 
acters in a variety of ways and convert between uppercase and lowercase 


characters. 


Routine 
isalnum 
isalpha 
isascil 


iscntrl 


Use 

Tests for alphanumeric character 
Tests for alphabetic character 
Tests for ASCH character 


Tests for control character 
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Data Conversion 


isdigit 
isgraph 
islower 
isprint 
ispunct 
isspace 
isupper 
isxdigit 
toascii 


tolower 


_tolower 


toupper 


_toupper 


Routines by Category 


Tests for decimal digit 

Tests for printable character except space 
Tests for lowercase character 

Tests for printable character 

Tests for punctuation character 

Tests for white-space character 

Tests for uppercase character 

Tests for hexadecimal digit 

Converts character to ASCII code 


Tests character and converts to lowercase if 
uppercase 


Converts character to lowercase (unconditional) 


Tests character and converts to uppercase if 
lowercase 


Converts character to uppercase (unconditional) 


The data-conversion routines convert numbers to strings of ASCII characters, 
and vice versa. These routines are implemented as functions. 


Routine 
abs 
atof 
atoi 
atol 
_atold 
ecvt 
fevt 
gcvt 
itoa 


labs 


Use 

Finds absolute value of integer 
Converts string to float 
Converts string to int 
Converts string to long 
Converts string to long double 
Converts double to string 
Converts double to string 
Converts double to string 
Converts int to string 


Finds absolute value of long integer 
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Directory Control 


File Handling 


ltoa 
strtod 
strtol 
_strtold 
strtoul 


ultoa 
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Converts long to string 

Converts string to double 

Converts string to a long integer 

Converts string to long double 

Converts string to an unsigned long integer 


Converts unsigned long to string 


These routines let a program access, modify, and obtain information about the 
directory structure. These routines are functions. 


chdir 
_chdrive 
setcwd 
_getdewd 
_getdrive 
mkdir 
rmdir 


_searchenv 


Use 

Changes current working directory 

Changes current drive 

Gets current working directory 

Gets current working directory for the specified drive 
Gets the current disk drive 

Makes a new directory 

Removes a directory 


Searches for a given file on specified paths 


The file-handling routines let you create, manipulate, and delete files. They also 
set and check file-access permissions. 


access 
chmod 
chsize 
filelength 
fstat 


Use 

Checks file-permission setting 
Changes file-permission setting 
Changes file size 

Gets file length 


Gets file-status information on handle 
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Graphics 


_fullpath Makes an absolute path name from a relative path 
name 

isatty Checks for character device 

locking Locks areas of file (available with OS/2 and 
DOS versions 3.0 and later) 

_makepath Merges path-name components into a single, full 
path name 

mktemp Creates unique file name 

remove Deletes file 

rename Renames file 

setmode Sets file-translation mode 

_splitpath Splits a path name into component pieces 

stat Gets file-status information on named file 

umask Sets default-permission mask 

unlink Deletes file 


Microsoft C graphics routines offer a wide variety of graphics functions, low- 
level graphics primitives, font functions, and presentation graphics (displays such 
as graphs and pie charts). 


Low-Level Graphics and Character-Font Functions 


Routine Use 

_arc, arc _wW, Draws an arc 

_arc_WXxy 

_clearscreen Clears the screen and fills it with the current back- 


ground color 


_displaycursor Sets the cursor on or off on exit from a graphics 
routine 
ellipse, ellipse_w, Draws an ellipse or circle 


_ellipse_wxy 


_floodfill, Flood-fills an area of the screen with the current 
_floodfill_w color 
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_getactivepage 


_getarcinfo 


_getbkcolor 
_getcolor 


_getcurrentposition, 
_getcurrentposition_w 


_getfillmask 
_getfontinfo 


_getgtextextent 


_getgtextvector 


_getimage, 
_getimage w, 
_getimage_wxy 


_getlinestyle 
_getphyscoord 
_getpixel, getpixel_w 
_gettextcolor 
_gettextcursor 
_gettextposition 
_gettextwindow 
_getvideoconfig 
_getvisualpage 
_getviewcoord 
_getviewcoord_w 


_getviewcoord_wxy 


_getwindowcoord 
_getwritemode 


_grstatus 


Gets the current active page number 


Determines the end points in viewport coordinates 
of the most recently drawn arc or pie 


Returns the current background color 
Gets the current color 


Obtains the current graphics-output position used by 
_lineto and _outgtext 


Gets the current fill mask 
Obtains the current font characteristics 


Determines the width in pixels of specified text in 
the current font 


Gets orientation of font text output 


Stores a screen image in memory 


Gets the current line style mask 

Converts view coordinates to physical coordinates 
Obtains a pixel’s color 

Obtains the current text color 

Returns the current cursor attribute (text modes only) 
Obtains the current text-output position 

Gets the current text window boundaries 

Obtains status of current graphics environment 
Gets the current visual page number 

Converts physical coordinates to view coordinates 
Converts window coordinates to view coordinates 


Converts window coordinates in _wxycoord struc- 
ture to view coordinates 


Converts view coordinates to window coordinates 
Gets the current logical write mode for line drawing 


Returns the status of the most recent graphics func- 
tion call 


for 
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_imagesize, Returns the size (in bytes) of the buffer needed to 

_Imagesize_w, store the image 

_Imagesize_wxy 

_lineto, lineto_w Draws a line from the current graphics output posi- 
tion to a specified point 

_moveto, moveto_w Moves the current graphics-output position to a 
specified point 

_outgtext Outputs the null-terminated text string using the cur- 


rent font and rotation on the screen at the current 
graphics-output position 


_outmem Prints text of a specified length from a memory 
buffer 

_outtext Outputs a text string to the screen at the current text 
position 

_pie, pie w, Draws a pie-slice-shaped figure 

_pie_wxy 

_ polygon, Draws or scan-fills a polygon 

_polygon_w, 


_polygon_wxy 
_putimage, Retrieves an image from memory and displays it 
_putimage _w 


_rectangle, Draws or scan-fills a rectangle 
_rectangle w, 
_rectangle_wxy 


_registerfonts Initializes the font graphics system 
_remapallpalette Changes all colors in the current palette 
_remappalette Changes a single color in the current palette 
_scrolltextwindow Scrolls the current text window up or down 
_selectpalette Selects a predefined palette 

_setactivepage Sets memory area for the current active page 
_setbkcolor Sets the current background color 
_setcliprgn Limits graphic output to a region of the screen 
_setcolor Sets the current color 


_setfillmask Sets the current fill mask 
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_setfont 
_setgtextvector 
_setlinestyle 
_setpixel, setpixel_w 
_settextcolor 
_settextcursor 
_settextposition 
_settextrows 
_settextwindow 
_setvideomode 
_setvideomoderows 
_setvieworg 


_setviewport 


_setvisualpage 
_setwindow 
_setwritemode 


_unregisterfonts 


_wrapon 
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Finds a single font from the set of registered fonts 
Sets the current orientation for font text output 
Sets the current line style mask 

Sets a pixel’s color 

Sets the current text color 

Sets the current cursor attribute (text modes only) 
Sets the current text position 

Sets the number of text rows 

Defines the current text-display window 

Sets the video mode for the display screen 

Sets the video mode and the number of text rows 
Positions the view coordinate origin 


Limits graphics output to a region of the screen and 
positions the view coordinate origin to the upper left 
comer of that region 


Sets memory area for the current visual page 
Defines a floating-point window coordinate system 
Sets logical write mode for line drawing 


Frees memory previously allocated and used by 
_registerfonts 


Enables or disables line wrap 


Presentation Graphics Functions 


Routine 


_pg_analyzechart 
_pg_analyzechartms 


_pg_analyzepie 


ree 


Analyzes a single series of data for a bar, column, or 
line chart 


Analyzes a multiple series of data for a bar, column, 
or line chart 


Analyzes data for a pie chart 
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_pg_analyzescatter 


_pg_analyzescatterms 


_pg_ chart 
_pg_chartms 
_pg_chartpie 
_pg_chartscatter 


_pg_chartscatterms 
_pg_defaultchart 
_pg_getchardef 
_pg_getpalette 


_pg_getstyleset 
_pg_hlabelchart 
_pg_initchart 
_pg_resetpalette 
_pg_resetstyleset 
_pg_setchardef 


_pg_setpalette 


_pg_setstyleset 
_pg_vilabelchart 
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Analyzes a single series of data for a scatter diagram 


Analyzes a multiple series of data for a scatter 
diagram 


Displays a single-series bar, column, or line chart 
Displays a multiple-series bar, column, or line chart 
Displays a pie chart 

Displays a scatter diagram for a single series of data 


Displays a scatter diagram for more than one series 
of data 


Initializes all necessary variables in the chart en- 
vironment for a specified chart type 


Retrieves the current 8-by-8-pixel bit map for a 
specified character 


Retrieves current colors, line styles, fill patterns, and 
plot characters for all presentation graphics palettes 


Retrieves the contents of the current styleset 
Writes text horizontally on the screen 
Initializes the presentation graphics library 


Sets current colors, line styles, fill patterns, and plot 
characters to the default values for the current screen 
mode 


Resets the contents of the current styleset to the de- 
fault value for the current screen mode 


Sets the 8-by-8-pixel bit map for a specified 
character 


Sets current colors, line styles, fill patterns, and plot 
characters for all presentation graphics palettes 


Sets the contents of the current styleset 


Writes text vertically on the screen 
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Input and Output 


The input and output (I/O) routines of the standard C library allow you to read 
and write data to and from files and devices. 


Stream Routines 

Routine Use 

clearerr Clears the error indicator for a stream 

fclose Closes a stream 

fcloseall Closes all open streams 

fdopen Associates a stream with an open file handle 
feof Tests for end-of-file on a stream 

ferror Tests for error on a stream 

fflush Flushes a stream 

fgetc Reads a character from a stream (function version) 
fgetchar Reads a character from stdin (function version) 
fgetpos Gets the position indicator of a stream 

fgets Reads a string from a stream 

fileno Gets file handle associated with a stream 
flushall Flushes all streams 

fopen Opens a stream 

fprintf Writes formatted data to a stream 

fputc Writes a character to a stream (function version) 
fputchar Writes a character to stdout (function version) 
fputs Writes a string to a stream 

fread Reads unformatted data from a stream 

freopen Reassigns a FILE pointer to a new file 

fscanf Reads formatted data from a stream 

fseek Moves file position to a given location 


fsetpos 


Sets the position indicator of a stream 
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_fsopen 
ftell 
fwrite 
getc 
getchar 
gets 
getw 
printf 
pute 
putchar 
puts 
putw 
rewind 
rmtmp 
scanf 
setbuf 
setvbuf 
sprintf 


sscanf 


tempnam 


tmpfile 
tmpnam 
ungetc 
viprintf 
vprintf 


vsprintf 


Routines by Category 


Opens a stream with file sharing 

Gets current file position 

Writes unformatted data items to a stream 
Reads a character from a stream 

Reads a character from stdin 

Reads a line from stdin 

Reads a binary int item from stream 

Writes formatted data to stdout 

Writes a character to a stream 

Writes a character to stdout 

Writes a line to a stream 

Writes a binary int item to a stream 

Moves file position to beginning of a stream 
Removes temporary files created by tmpfile 
Reads formatted data from stdin 

Controls stream buffering 

Controls stream buffering and buffer size 
Writes formatted data to string 

Reads formatted data from string 

Generates a temporary file name in given directory 
Creates a temporary file 

Generates a temporary file name 

Places a character in the buffer 

Writes formatted data to a stream 

Writes formatted data to stdout 


Writes formatted data to a string 
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Low-Level Routines 


Routine 


close 
creat 
dup 
dup2 
eof 
Iseek 
open 
read 
sopen 
tell 
umask 


write 
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Use 

Closes a file 

Creates a file 

Creates a second handle for a file 
Reassigns a handle to a file 

Tests for end-of-file 

Repositions file pointer to a given location 
Opens a file 

Reads data from a file 

Opens a file for file sharing 

Gets current file-pointer position 
Sets default file-permission mask 


Writes data to a file 


Console and Port I/O 


Routine 


cgets 
cprintf 
cputs 
cscanf 
getch 
getche 
inp 
inpw 


kbhit 


Use 

Reads a string from the console 

Writes formatted data to the console 

Writes a string to the console 

Reads formatted data from the console 

Reads a character from the console 

Reads a character from the console and echoes it 
Reads one byte from the specified I/O port 

Reads a two-byte word from the specified I/O port 


Checks for a keystroke at the console 
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outp Writes one byte to the specified I/O port 

outpw Writes a two-byte word to the specified I/O port 
putch Writes a character to the console 

ungetch | “Ungets” the last character read from the console so 


that it becomes the next character read 


Internationalization 


Internationalization routines are useful for creating different versions of a pro- 
gram for international markets. 


Routine Use 


localeconv Sets a structure with appropriate values for format- 
ting numeric quantities 


setlocale Selects the appropriate locale for the program 

strcoll Compares strings using locale-specific information 

strftime Formats a date and time string 

strxfrm Transforms a string based on locale-specific 
information 


Math 


The math routines allow you to perform common mathematical calculations. 
Many math routines work with floating-point values and therefore require 
floating-point support, which is linked in from the C run-time library. Routines 
ending with | support an 80-bit data type for the corresponding routines. These 
routines return a long double value. 


Routine Use 

acos, acosl Calculates the arccosine 
asin, asin Calculates the arcsine 
atan, atanl Calculates the arctangent 
atan2, atan21 Calculates the arctangent 
bessel! Calculates Bessel functions 


cabs, cabsl Finds the absolute value of a complex number 
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ceil, ceill 
_clear87 


_control87 


cos, cosl 
cosh, coshl 


dieeetomsbin 


div 


dmsbintoieee 


exp, expl 
fabs, fabsl 


fieeetomsbin 
floor, floor! 


fmod, fmodl 


fmsbintoieee 


_fpreset 
frexp, frexpl 
hypot, hypotl 
Idexp, Idexpl 
Idiv 


log, logl 
log10, log101 


_Irotl, _lrotr 


matherr, matherrl 


max, min 
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Finds the integer ceiling 
Gets and clears the floating-point status word 


Gets the old floating-point control word and sets a 
new control-word value 


Calculates the cosine 
Calculates the hyperbolic cosine 


Converts IEEE double-precision number to 
Microsoft (MS) binary format 


Divides one integer by another, returning the 
quotient and remainder 


Converts Microsoft binary double-precision number 
to IEEE format 


Calculates the exponential function 
Finds the absolute value 


Converts IEEE single-precision number to Microsoft 
binary format 


Finds the largest integer less than or equal to the 
argument 


Finds the floating-point remainder 


Converts Microsoft binary single-precision number 
to IEEE format 


Reinitializes the floating-point-math package 
Calculates an exponential value 

Calculates the hypotenuse of right triangle 
exp 


Calculates the argument times 2 


Divides one long integer by another, returning the 
quotient and remainder 


Calculates the natural logarithm 
Calculates the base-10 logarithm 


Shifts an unsigned long int item left (_Irotl) or right 
( lrotr) 


Handles math errors 


Returns the larger or smaller of two values 
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modf, modfl Breaks down the argument into integer and frac- 
tional parts 

pow, powl Calculates a value raised to a power 

rand Gets a pseudorandom number 

_rotl, rotr Shifts an unsigned int item left (_ rotl) or right 
(_ rotr) 

sin, sinl Calculates the sine 

sinh, sinhl Calculates the hyperbolic sine 

sqrt, sqrtl Finds the square root 

srand Initializes a pseudorandom series 

_status87 Gets the floating-point status word 

tan, tanl Calculates the tangent 

tanh, tanhl Calculates the hyperbolic tangent 

| The bessel routine does not correspond to a single function, but to 12 functions named jo, jl, jn, 

y0, yl, yn, jOl, ji, _jol, y0l, yl, and_ynl. 

Memory Allocation 

The memory-allocation routines allow you to allocate, free, and reallocate blocks 

of memory. 

alloca Allocates a block of memory from the program’s 
stack 

_bfreeseg Frees a based heap 

_bheapseg Allocates a based heap 


calloc, bcalloc, 
_fcalloc, ncalloc 


_expand, bexpand, 
_fexpand, nexpand 


free, bfree, 
_ffree, nfree 


_freect 


Allocates storage for an array 


Expands or shrinks a block of memory without 
moving its location 


Frees an allocated block 


Returns approximate number of items of given size 
that could be allocated in the near heap 
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halloc 
_heapadd, bheapadd 


_heapchk, 

_bheapchk, 
_fheapchk, 
_nheapchk 


_heapmin, 
_bheapmin, 
_fheapmin, 
_nheapmin 
_heapset, bheapset, 
_fheapset, nheapset 


_heapwalk, 

_bheapwalk, 
_fheapwalk, 
_nheapwalk 


hfree 


malloc, bmalloc, 
_fmalloc, nmalloc 


_memavl 
_memmax 


_msize, bmsize, 
_fmsize, nmsize 


realloc, brealloc, 
_frealloc, nrealloc 


stackavail 


Process and Environment Control 
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Allocates storage for huge array 
Adds memory to a heap 


Checks a heap for consistency 


Releases unused memory in a heap 


Fills free heap entries with a specified value 


Returns information about each entry in a heap 


Frees a block allocated by halloc 


Allocates a block of memory 


Returns approximate number of bytes available for 
allocation in the near heap 


Returns size of largest contiguous free block in the 
near heap 


Returns size of an allocated block 


Reallocates a block to a new size 


Returns size of stack space available for allocation 
with alloca 


The process-control routines allow you to start, stop, and manage processes from 
within a program. Environment-control routines allow you to get and change in- 
formation about the operating-system environment. 
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Routine 


abort 


assert 


atexit 
_beginthread 
_cexit 


_c exit 


cwait 


_endthread 
execl 


execle 


-execip 


execlpe 


execv 


execve 


execvp 


execvpe 


exit 


_exit 
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Use 


Aborts a process without flushing buffers or calling 
functions registered by atexit and onexit 


Tests for logic error 


Schedules routines for execution at program 
termination 


Creates an execution thread (OS/2 only) 


Performs the exit termination procedures (such as 
flushing buffers) and returns control to the calling 
program 


Performs the _ exit termination procedures without 
performing clean-up operations and returns control 
to the calling program 


Suspends the calling process until a specified child 
process terminates (OS/2 only) 


Terminates an execution thread (OS/2 only) 
Executes child process with argument list 


Executes child process with argument list and given 
environment 


Executes child process using PATH variable and ar- 
gument list 


Executes child process using PATH variable, given 
environment, and argument list 


Executes child process with argument array 


Executes child process with argument array and 
given environment 


Executes child process using PATH variable and ar- 
gument array 


Executes child process using PATH variable, given 
environment, and argument array 


Calls functions registered by atexit and onexit, then 
flushes all buffers and closes all open files before ter- 
minating the process 


Terminates process without processing atexit or 
onexit functions or flushing buffers 
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getenv 
getpid 
longjmp 


onexit 


_pclose 


perror 
_pipe 


_popen 
puteny 


raise 
setjmp 
signal 
spawnl 


spawnle 


spawnlp 


spawnlpe 


spawnv 


spawnve 


spawnvp 


spawnvpe 


system 


wait 


Gets the value of an environment variable 
Gets process ID number 
Restores a saved stack environment 


Schedules routines for execution at program 
termination 


Waits for a child command and closes the pipe on 
the associated stream 


Prints error message 
Creates a pipe 


Creates a pipe and asynchronously executes a child 
copy of the command processor 


Adds or changes the value of an environment 
variable 


Sends a signal to the calling process 
Saves a stack environment 

Handles an interrupt signal 

Executes child process with argument list 


Executes. child process with argument list and given 
environment 


Executes child process using PATH variable and ar- 
gument list 


Executes child process using PATH variable, given 
environment, and argument list 


Executes child process with argument array 


Executes child process with argument array and 
given environment 


Executes child process using PATH variable and ar- 
gument array 


Executes child process using PATH variable, given 
environment, and argument array 


Executes an operating-system command 


Suspends the calling process until any of the caller’s 
immediate child processes terminate (OS/2 only) 


oon. 
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Searching and Sorting 


Search and sort routines provide binary-search, linear-search, and quick-sort 


capabilities. 


Routine 
bsearch 
Ifind 


Isearch 


qsort 


String Manipulation 


Use 
Performs binary search 
Performs linear search for given value 


Performs linear search for given value, which is 
added to array if not found 


Performs quick sort 


The string functions allow you to compare strings, copy them, search for strings 
and characters, and perform various other operations. 


Routine 

streat, fstreat 
strchr, fstrchr 
stremp, fstremp 
strepy, fstrepy 


strespn, fstrespn 


strdup, fstrdup, 
_nstrdup 


strerror 

_Strerror 

stricmp, fstricmp 
strlen, fstrlen 
striwr, fstrlwr 
strneat, fstrncat 
strnemp, fstrncmp 


strnepy, fstrncpy 


Use 

Appends one string to another 

Finds first occurrence of a given character in string 
Compares two strings 

Copies one string to another 


Finds first occurrence of a character from given char- 
acter set in string 


Duplicates a string 


Maps an error number to a message 

Maps a user-defined error message to a string 
Compares two strings without regard to case 
Finds length of string 

Converts string to lowercase 

Appends characters of string 

Compares characters of two strings 


Copies characters of one string to another 
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System Calls 


strnicmp, fstrnicmp 


strnset, fstrnset 


strpbrk, fstrpbrk 


strrchr, fstrrchr 
strrev, fstrrev 
strset, fstrset 


strspn, fstrspn 
strstr, fstrstr 


strtok, fstrtok 


strupr, fstrupr 


Compares characters of two strings without regard 
to case 


Sets characters of string to given character 

Finds first occurrence of character from one string in = 
another 

Finds last occurrence of given character in string 

Reverses string 

Sets all characters of string to given character 


Finds first substring from given character set in 
string 


Finds first occurrence of given string in another 
string 


Finds next token in string 


Converts string to uppercase 


The following routines give access to IBM-PC BIOS (Basic Input/Output 
System) interrupts and DOS system calls. 


BIOS Interface 


Routine 


_bios_disk 


_bios_equiplist 


_bios_keybrd 
_bios_memsize 


_bios_printer 


_bios_serialcom 


_bios_timeofday 


Use 


Issues service requests for both hard and floppy 
disks, using INT 0x13 


Performs an equipment check, using INT 0x11 


Provides access to keyboard services, using 
INT 0x16 


Obtains information about available memory, using 
INT 0x12 


Performs printer output services, using INT 0x17 


Performs serial communications tasks, using 
INT 0x14 


Provides access to system clock, using INT 0x1A 
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DOS Interface 


Routine 


bdos 


_chain_intr 
_ disable 


_dos_allocmem 


_dos_close 


_dos_creat 


_dos_creatnew 


_dos_findfirst 
_dos_findnext 
_dos freemem 


_dos_ getdate 
_dos_getdiskfree 


_dos_getdrive 
_dos_getfileattr 
_dos_getftime 
_dos_gettime 


_dos_getvect 


Use 


Invokes DOS system call; uses only DX and AL 
registers 


Chains one interrupt handler to another 
Disables interrupts 


Allocates a block of memory, using DOS system 
call 0x48 


Closes a file, using DOS system call 0x3E 


Creates a new file and erases any existing file 
having the same name, using DOS system call 0x3C 


Creates a new file and returns an error if a file 
having the same name exists, using DOS system call 
Ox5B 


Finds first occurrence of a given file, using DOS sys- 
tem call Ox4E 


Finds subsequent occurrences of a given file, using 
DOS system call Ox4F 


Frees a block of memory, using DOS system call 
Ox49 


Gets the system date, using DOS system call 0x2A 


Gets information on a disk volume, using DOS sys- 
tem call 0x36 


Gets the current default drive, using DOS system 
call 0x19 


Gets current attributes of a file or directory, using 
DOS system call 0x43 


Gets the date and time a file was last written, using 
DOS system call 0x57 


Gets the current system time, using DOS system call 
Ox2C 


Gets the current value of a specified interrupt vector, 
using DOS system call 0x35 
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_dos_keep 


_dos_ open 
_dos_read 


_dos_setblock 
_dos_setdate 
_dos_setdrive 
_dos_setfileattr 
_dos_setftime 


_dos_settime 


_dos_setvect 


_dos_ write 


dosexterr 


_enable 


FP_OFF 
FP_SEG 


_harderr 
_hardresume 


_hardretn 


Installs terminate-and-stay-resident (TSR) programs 
using DOS system call 0x31 


Opens an existing file, using DOS system call 0x3D 
Reads a file, using DOS system call Ox3F 


Changes the size of a previously allocated block, 
using DOS system call Ox4A 


Sets the current system date, using DOS system call 
Ox2B 


Sets the default disk drive, using DOS system call 
OxOE 


Sets the current attributes of a file, using DOS sys- 
tem call 0x43 


Sets the date and time that the specified file was last 
written, using DOS system call 0x57 


Sets the system time, using DOS system call 0x2D 


Sets a new value for the specified interrupt vector, 
using DOS system call 0x25 


Sends output to a file, using DOS system call 0x40 


Obtains in-depth error information from DOS sys- 
tem call 0x59 


Enables interrupts 


Returns offset portion of a far pointer (OS/2 and 
DOS) 


Returns segment portion of a far pointer (OS/2 and 
DOS) 


Establishes a hardware error handler 
Returns to DOS after a hardware error 


Returns to the application after a hardware error 
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int86 Invokes DOS interrupts 
int86x Invokes DOS interrupts with segment register values 
intdos Invokes DOS system call using registers other than 
DX and AL 
intdosx Invokes DOS system call using registers other than 
DX and AL with segment register values 
segread Returns current values of segment registers (OS/2 
and DOS) 
Time 


The time functions allow you to obtain the current time, then convert and store it. 
The current time is always taken from the system time. 


Routine 
asctime 
clock 
ctime 
difftime 


ftime 


emtime 


localtime 


mktime 

_strdate 
strftime 
_strtime 
time 


tzset 


utime 


Use 

Converts time from type struct tm to character string 
Returns the elapsed CPU time for a process 

Converts time from long integer to character string 
Computes the difference between two times 


Puts current system time in variable of type struct 
tm 


Converts time from integer to struct tm 


Converts time from integer to struct tm with local 
correction 


Converts time to a calendar value 

Returns the current system date as a string 
Formats a date and time string 

Returns the current system time as a string 
Gets current system time as long integer 


Sets external time variables from environment time 
variable 


Sets file-modification time 
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Variable-Length Argument Lists 


The va_arg, va_end, and va_start routines are macros that provide a portable 
way to access the arguments to a function when the function takes a variable 
number of arguments. 


Routine Use 
va_arg Retrieves argument from list 
va_end Resets pointer 


va_start Sets pointer to beginning of argument list 


abs 


access 


access 


void abort( void ); 


Include PROCESS.H or STDLIB.H 


Returns No return value 


Aborts the current process. 


MANS! @ DOS 8 OS/2 MUNIX” @ XENIX 


int abs( int 7 ); 


Include STDLIB.H or MATH.H 
n Value whose absolute value is sought 
Returns The absolute value of n 


Calculates the absolute value of its argument. 


MANS! @ DOS @OS/2 WM UNIX” MW XENIX 


int access( char *pathname, int mode ); 


Include 1IO.H, ERRNO.H 

pathname File or directory path name 

mode 00 (exist), 02 (write), 04 (read), 06 (read/write) 

Returns O if the file has the given access mode or if the directory exists; —1 if 
the directory or file does not exist or does not have the given mode 

errno EACCESS, ENOENT 


Determines whether a specified file or directory exists, and (in the case of a file) whether it 
can be accessed in the specified mode. 


OANS| @ DOS #8 OS/2 MUNIX” Mi XENIX 


acosl 


alloca 
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double acos( double x ); 


Include MATH.H, ERRNO.H 

x Value whose arccosine is sought 
Returns 0 if x is less than —1 or greater than 1 
errno EDOM 


Returns the arccosine of x in the range O to pi radians. 


MANS! M@ DOS 8 OS/2 MUNIX’ i XENIX 


long double acosI( long double x ); 


Include MATH.H, ERRNO.H 

Value whose arccosine is sought 
Returns 0 if x is less than —1 or greater than 1 
errno EDOM 


Returns the arccosine of x in the range 0 to pi radians. Long double-precision floating- 
point version of acos. 


O ANS! @ DOS @OS/2 OUNIX OC XENIX 


void “alloca( size_t size ); 


Include MALLOC.H 

size Bytes to be allocated from the stack 

Returns A void pointer to the allocated space; NULL if the space cannot be 
allocated 


Allocates size bytes from the program’s stack. 


OhANS|! @ DOS WMOS/2 OUNIX OC XENIX 
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arc 
short far arc( short x/, short y/, short x2, short y2, short x3, short y3, 
short x4, short y4 ); 

Include GRAPH.H 

xl, yl Upper left corner of bounding rectangle 

x2, y2 Lower right corner of bounding rectangle 

x3, V3 Start vector 

x4, y4 End vector 

Returns A nonzero value if anything is drawn; 0 if nothing is drawn 

Draws an elliptical arc using the view coordinate system. 

OANS| DOS OOS/2 OUNIX OC XENIX 

_arct_W 
short far arc_w( double x/, double y/, double x2, double y2, double x3, double y5, 
double x4, double y4 ); 

Include GRAPH.H 

xl, yl Upper left corner of bounding rectangle 

x2, y2 Lower right corner of bounding rectangle 

x3, y3 Second point of start vector (center of bounding rectangle is first 
point) 

x4, y4 Second point of end vector (center of bounding rectangle is first 
point) 

Returns A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws an elliptical arc using the window coordinate system. 


O ANS! m DOS OOS/2 OUNIX OC XENIX 


_are_WXy 


_arc_wxy 


asctime 
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short far _arc_wxy(struct wxycoord far *pwxyl, struct wxycoord far *pwxy2, 
struct wxycoord far *pwxy3, struct wxycoord far “pwxy4 ); 


Include GRAPH.H 

pwxyl Upper left corner of bounding rectangle 

pwxy2 Lower right corner of bounding rectangle 

pwxy3 Start vector 

pwxy4 End vector 

Returns A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws an elliptical arc using the window coordinate system. 


OANS|! @ DOS OOS/2 OUNIX OF XENIX 


char *asctime( const struct tm *timepir ); 


Include TIME.H 
timeptr Time/date structure defined in TIME.H 
Returns A pointer to the character string result 


Converts a value stored as a tm time structure to a character string. 


MANS! @ DOS WW OS/2 MUNIX Wf XENIX 
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asin 
double asin( double x ); 
Include MATH.H, ERRNO.H 
x Value whose arcsine is sought 
Returns 0 if x is less than —1 or greater than 1 
errno EDOM 
Calculates the arcsine of a value in the range —pi/2 to pi/2 radians. 
MANS! M@DOS #8 OS/2 MUNIX’ Wi XENIX 
asinl 
long double asinl( long double x ); 
Include MATH.H, ERRNO.H 
x Value whose arcsine is sought 
Returns O if x is less than —1 or greater than 1 
errno EDOM 
Calculates the arcsine of a value in the range —pi/2 to pi/2 radians. Long double-precision 
floating-point version of asin. 
O ANS! @ DOS @ OS/2 OUNIX OC XENIX 
assert 


void assert( int expression ); 


Include ASSERT.H, STDIO.H 
expression A logical expression 
Returns No return value 


Prints a diagnostic message and calls the abort routine if a logical expression is false (0). 
Activated only if NDEBUG is defined at compile time. 


MANS! @ DOS #8 OS/2 MUNIX” Wf XENIX 


atanl 
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double atan( double x ); 


Include MATH.H, ERRNO.H 

x Value whose arctangent is sought 
Returns The arctangent result; O if x is 0 
errno EDOM 


Calculates the arctangent of x in the range —pi/2 to pi/2. 


MANS! @ DOS WOS/2 MUNIX Wi XENIX 


long double atanl( long double x ); 


Include MATH.H, ERRNO.H 

x Value whose arctangent is sought 
Returns The arctangent result; O if x is 0 
errno EDOM 


Calculates the arctangent of x in the range —pi/2 to pi/2. Long double-precision floating- 
point version of atan. 


O ANS! @ DOS WW OS/2 OUNIX OC XENIX 


atan2| 


atexit 


atexit 


double atan2( double y, double x ); 


Include MATH.H, ERRNO.H 

y/x Value whose arctangent is sought 
Returns The arctangent result; 0 if x or y is O 
errno EDOM 


Calculates the arctangent of y/x in the range —pi to pi. 
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long double atan2I( long double y, long double x ); 


Include MATH.H, ERRNO.H 

y/x Value whose arctangent is sought 
Returns The arctangent result; 0 if x or yis O 
errno EDOM 


Calculates the arctangent of y/x in the range —pi to pi. Long double-precision floating-point 
version of atan2. 
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int atexit( void( *func )( void ) ); 


Include STDLIB.H 
func Function to call on exit 
Returns 0 if successful; a nonzero value if not 


Calls the specified function at exit. Successive calls create a register of up to 32 functions 
to be called (last in, first out). 
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atol 


double atof( const char *string ); 


Include MATH.H or STDLIB.H 
string String to be converted 
Returns The converted string; 0 if the string cannot be converted 


Converts a character string to a double-precision floating-point value. 
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int atoi( const char “string ); 


Include STDLIB.H 
string String to be converted 
Returns The converted string; 0 if the string cannot be converted 


Converts a character string to an integer value. 
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long atol( const char *string ); 


Include STDLIB.H 
string String to be converted 
Returns The converted string; 0 if the string cannot be converted 


Converts a character string to a long integer value. 
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_bealloc 


_bealloc 


long double _atold( const char *string ); 


Include MATH.H or STDLIB.H 
string String to be converted 
Returns The converted string; 0 if the string cannot be converted 


Converts a character string to a long double-precision floating-point value. 
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void based( void ) * bcalloc( segment seg, size_t num, size_t size ); 


Include MALLOC.H 

seg Based-heap segment selector 

num Number of elements 

size Length in bytes of each element 

Returns A based pointer to the allocated space; NULLOFF if there is insuffi- 


cient memory available, if num or size is O, or if the specified 
segment has not been initialized as part of the based heap 


Allocates array storage on the specified based heap. 
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int bdos( int dosfunc, unsigned int dosdx, unsigned int dosal ); 


Include DOS.H 

dosfunc Function number 

dosdx DX register value 

dosal AL register value 

Returns The value of the AX register after the system call has completed 


Invokes the DOS system call specified by a function number. 
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int far beginthread( void( far *start_address )( void _far * ), 
void far *stack_ bottom, unsigned stack_size, void far *arglist ); 


Include PROCESS.H, STDDEF.H, ERRNO.H 

start_address Address where execution begins 

stack_bottom Address of the thread stack or NULL 

stack size Stack space to reserve 

arglist Address of data item to pass to new thread 

Returns The thread identification number of the new thread if successful; 
—1 to indicate an error if not 

errno EINVAL, EAGAIN 


Creates a thread that begins execution at start_address. 
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_bfree 


_bexpand 


_bfree 


void based( void ) * bexpand( segment seg, void based( void ) *memblock, 


size_t size ); 
Include MALLOC.H 
seg | Based-heap segment selector 
memblock Pointer to previously allocated memory 
size New size in bytes 
Returns A based pointer to the resized memory block if successful; 


_NULLOFF if not 
Changes the size of a block in the based heap. 
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void bfree(_ segment seg, void based( void ) *memblock ); 


Include MALLOC.H 

seg Segment selected 
memblock Allocated memory block 
Returns No return value 


Frees a memory block in the based heap (previously allocated by a call to _bmalloc or 
_brealloc). 
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_bfreeseg 
int bfreeseg( segment seg ); 
Include MALLOC.H 
seg Based-heap segment selector 
Returns O if successful; —1 in the case of an error 
Frees a specified based-heap segment. 
O ANS! @ DOS @OS/2) OUNIX OC XENIX 
_bheapadd 
int bheapadd( segment seg, void _based( void ) “memblock, size_t size ); 
Include MALLOC.H 
seg Based-heap segment selector 
memblock Pointer to based memory 
size Size in bytes of memory to add 
Returns A segment selector if successful; —1 if not 
Adds an unused piece of memory to the specified based heap. 
O ANS! @ DOS @ OS/2 OUNIX OC XENIX 
_bheapchk 
int bheapchk( segment seg ); 
Include MALLOC.H 
seg Based-heap segment to check or NULLSEG to check all based-heap 
segments 
Returns _HEAPOK, HEAPEMPTY, HEAPBADBEGIN, 
_HEAPBADNODE 


Checks for minimal consistency in the based heap specified by the selector value seg. 
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_bheapmin 
int bheapmin( segment seg ); 
Include MALLOC.H 
seg Based-heap segment to minimize, or _NULLSEG for all based-heap 
segments 
Returns 0 if successful; —1 if not 
Releases unused memory in the based heap, minimizing the heap. 
O ANS! @ DOS #8 OS/2 OUNIX' OC XENIX 
_bheapseg 
_segment bheapseg( size_t size ); 
Include MALLOC.H 
size Segment size to allocate 
Returns The selector for the newly allocated segment if successful; —1 if not 
Allocates a based-heap segment. 
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int bheapset( segment seg, unsigned int fill ); 


Include MALLOC.H 

seg Based-heap segment selector or NULLSEG for all based-heap 
segments 

fill Fill character 

Returns _HEAPOK, HEAPEMPTY, HEAPBADBEGIN, 
_HEAPBADNODE 


Checks for minimal consistency in the based-heap segment specified by the selector value 
seg, and then sets the heap’s free entries with the fill value. 
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int bheapwalk( segment seg, HEAPINFO “*entryinfo ); 


Include MALLOC.H 

seg Based-heap selector or NULLSEG for all based-heap segments 

entryinfo Structure to contain information about the next heap entry, defined in 
MALLOC.H 

Returns HEAPOK, HEAPEMPTY, HEAPBADPTR, HEAPBADBEGIN, 


~-HEAPBADNODE, HEAPEND 
Walks through the based-heap segment specified by the selector seg (or all based-heap 
segments if seg is equal to NULLSEG), one entry per call, returning a pointer to a 


_HEAPINFO structure that contains information about the next based-heap entry. 
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unsigned bios _disk( unsigned service, struct diskinfo_t “diskinfo ); 


Include BIOS.H 

service _DISK_RESET, DISK STATUS, DISK_READ, DISK_WRITE, 
"DISK_VERIFY, DISK_FORMAT 

diskinfo Disk parameters structure defined in BIOS.H 

Returns The value stored in the AX register upon return from the BIOS 
interrupt 


Calls BIOS disk-access services (INT 0x13). 
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_bios_memsize 


_bios_equiplist 


_bios_keybrd 


unsigned _bios_equiplist( void ); 
Include BIOS.H 


Returns A set of bits indicating what is installed 


Calls INT 0x11 to determine what hardware and peripherals are currently installed on the 
machine. 


O ANSI! @ DOS OOS/2 OUNIX OC XENIX 


unsigned bios keybrd( unsigned service ); 


Include BIOS.H 


service _KEYBRD READ, N KEYBRD READ, KEYBRD READY, 
"N_KEYBRD READY, KEYBRD SHIFTSTATUS, 
_N_KEYBRD_SHIFTSTATUS 


Returns | The value returned in the AX register upon return from the BIOS 
interrupt 


Calls BIOS keyboard services (INT 0x16). 
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_bios_memsize 


unsigned bios _memsize( void ); 


Include BIOS.H 


Returns The total amount of installed memory in 1K blocks 


Calls BIOS memory-size service (INT 0x12) to determine the total amount of main 
memory installed. 
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_bios_printer 


unsigned _bios_printer( unsigned service, unsigned printer, unsigned data ); 


Include BIOS.H 

service _PRINTER_ WRITE, PRINTER_INIT, PRINTER _STATUS 

printer Target printer port 

data Output data 

Returns The value returned in the AX register upon return from the BIOS 
interrupt 


Calls BIOS printer services (INT 0x17) to perform printer tasks for parallel printers. 
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_bios_serialcom 


unsigned _bios_serialcom( unsigned service, unsigned serial_port, unsigned data ); 


Include BIOS.H 

service _COM_INIT, COM_RECEIVE, COM_SEND, 
_COM_STATUS 

serial port Serial port to use 

data COM _CHR7, COM _CHR8, COM_STOP1, COM_STOP2, 


COM NOPARITY, COM EVENPARITY, 
~“COM_ODDPARITY, COM 110, COM_150, COM_300, 
~COM_600, COM 1200, COM 2400, COM _4800, COM_9600 


Returns A 16-bit integer whose meaning varies depending on the service 
requested 


Calls BIOS communications services (INT 0x14) to provide serial communications. 
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_bmalloe 


i eT eg 
_bios_timeofday 


_bmalloc 


unsigned bios _timeofday( unsigned service, long *timeval ); 


Include BIOS.H 

service _TIME_GETCLOCK, TIME SETCLOCK 

timeval Clock count 

Returns The value returned in the AX register upon return from the BIOS 
interrupt 


Calls BIOS time and date services (INT 0x1A) to get or set the current system clock count. 
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void _based( void ) *_bmalloc( segment seg, size_t size ); 


Include MALLOC.H 

seg Based-heap segment selector 

size Number of bytes to allocate 

Returns A void pointer to the allocated space; _NULLOFF if it fails 


Allocates a memory block of at least size bytes in the based-heap segment specified by the 
selector seg. 
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_bmsize 
size t_bmsize(_segment seg, void _based( void ) *memblock ); 
Include MALLOC.H 
seg Based-heap segment selector 
memblock Pointer to based-heap memory block 
Returns The size in bytes 
An unsigned integer representing the size in bytes of the based-heap memory block allo- 
cated by acall to _bcalloc, bmalloc, or _brealloc. 
OANS| @ DOS W@ OS/2 OUNIX OC XENIX 
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void based( void ) * brealloc( segment seg, void _based( void ) *memblock, 
size_t size ); 


Include MALLOC.H 

seg Based-heap segment selector 

memblock Pointer to previously allocated memory block 

size New size in bytes 

Returns A void _based pointer to the reallocated memory block if successful; 
_NULLOFF if not 


Changes the size of a previously allocated based-heap memory block, possibly relocating it. 
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cabs 
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bsearch 


cabs 


void *“bsearch( const void “key, const void *base, size_t num, size_t width, 
int (*compare )( const void *elem/, const void *“elem2 ) ); 


Include STDLIB.H, SEARCH.H 


key Pointer to object to search for 

base Pointer to base of search data 

num Number of elements 

width Width of elements 

compare Comparison function 

elem! Pointer to the key for the search 

elem2 Pointer to the array element to be compared with the key 

Returns A pointer to the first occurrence of the object pointed to by key in the 


array that base points to; NULL if key is not found 


Performs a binary search of a sorted array. Note that key is a pointer to an object of size 
width. 
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double cabs( struct complex z ); 


Include MATH.H, ERRNO.H 

Z Complex number structure defined in MATH.H 
Returns HUGE_VAL on overflow 

errno ERANGE 


Calculates the absolute value of a complex number. 
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long double cabsl( struct _complex! z ); 


Include MATH.H, ERRNO.H 

z Long double-precision complex number structure defined in 
MATH.H 

Returns The absolute value if successful; LLHUGE_VAL on overflow 

errno ERANGE 


Calculates the absolute value of a complex number. Long double-precision floating-point 
version of cabs. 
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void *calloc( size_t num, size_t size ); 


Include STDLIB.H or MALLOC.H 

num Number of elements 

Size Length in bytes of each element 

Returns A pointer to the allocated space; NULL if there is insufficient 


memory available 
Allocates storage for an array of num elements of size bytes. All bytes are initialized to 0. 
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ceil 
double ceil( double x ); 
Include MATH.H 
x Floating-point value 
Returns A value representing the smallest integer that is greater than or equal 
to the argument 
Calculates the ceiling of a value. 
MANS! @DOS 8 OS/2 MUNIX” fi XENIX 
ceill 
long double ceill( long double x ); 
Include MATH.H 
x Long double-precision floating-point value 
Returns The long double result, rounded up 
Returns a long double-precision floating-point value representing the smallest integer that 
is greater than or equal to the argument. | 
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void _cexit( void ); 


Include PROCESS.H 


Returns No return value 


Performs the exit termination procedures (e.g., flushing buffers) but returns control to the 
caller; does not terminate the process. 
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_chain_intr 
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void c_exit( void ); 


Include PROCESS.H 


Returns No return value 


Performs _ exit termination procedures (i.e., without cleanup operations), but returns con- 
trol to the caller; does not terminate the process. 
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char “cgets( char *buffer ); 


Include CONIO.H 
buffer Storage location for data 
Returns A pointer to the start of a string of characters 


Reads a string of characters (excluding terminal \n) directly from the console and stores the 
string and its length in buffer. 
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void chain _intr( void(_interrupt far *sarget CO) )s 


Include DOS.H 
target Target interrupt routine 
Returns No return value 


Chains one interrupt handler to another interrupt handler. 
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_chdrive 


_chdrive 


int chdir( char *dirname ); 


Include — DIRECT.H, ERRNO.H 

dirname Path name of new working directory 

Returns O if the working directory is successfully changed; —1 if the specified 
path name could not be found 

errno ENOENT 


Changes the current working directory. 
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int chdrive( int drive ); 


Include DIRECT.H 
drive Number of new working drive (A: = 1, B: = 2) 
Returns 0 if the working drive is successfully changed; —1 if not 


Changes the current working drive. 
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int chmod( char *filename, int pmode ); 


Include SYS\TYPES.H, SYS\STAT-H, 10.H, ERRNO.H 

filename Path name of existing file 

pmode Permission setting for file 

Returns O if the permission setting is successfully changed; ENOENT if the 
specified file could not be found 

errno ENOENT 


Changes file permission settings. 
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int chsize( int handle, long size ); 


Include 10.H, ERRNO.H 

handle Handle referring to open file 

size New length of file in bytes 

Returns O if the file size is successfully changed; —1 if not 
errno EACCESS, EBADF, ENOSPC 


Changes the size of a file. 
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unsigned int clear87( void ); 


Include FLOAT.H 


Returns A word whose bits indicate the floating-point status 


Gets and clears a floating-point status word. 
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clearerr 


_clearscreen 


clock 


void clearerr( FILE *stream ); 


Include STDIO.H 
stream Pointer to FILE structure 
Returns No return value 


Resets the error and end-of-file indicators for a stream. 
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void far _clearscreen( short area ); 


Include GRAPH.H 
area _GCLEARSCREEN, GVIEWPORT, GWINDOW 
Returns No return value 


Clears the screen and fills it with the current background color. 
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clock_t clock( void ); 


Include TIME.H 


Returns The elapsed processor time; —1, cast as clock_t, if the processor time 


is not available 


Calculates how much processor time in seconds has been used by the calling process. 
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int close( int handle ); 


Include 1O.H, ERRNO.H 

handle Handle referring to open file 

Returns O if the file was successfully closed; —1 if the file-handle argument is 
invalid 

errno EBADF 


Closes a file. 
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unsigned int _control87( unsigned int new, unsigned int mask ); 


Include FLOAT.H 

new New control-word bit values 

mask Mask for new control-word bits to set 

Returns A word whose bits indicate the floating-point control state 


Gets and sets the floating-point control word. 
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double cos( double x ); 


Include MATH.H, ERRNO.H 

x Radians 

Returns The cosine of x; 0 if x is so large that significance is completely lost 
errno ERANGE 


Calculates the cosine of x. 
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cosh 
double cosh( double x ); 
Include MATH.H, ERRNO.H 
x Radians 
Returns The hyperbolic cosine of x; 0 if x is so large that significance is 
completely lost; HUGE_VAL if the result is too large 
errno ERANGE 
Calculates the hyperbolic cosine of x. 
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long double coshl( long double x ); 


Include MATH.H, ERRNO.H 

x Radians 

Returns The hyperbolic cosine of x if successful; 0 if x is so large that signifi- 
cance is completely lost; LLHUGE_VAL if the result is too large 

errno ERANGE 


Calculates the hyperbolic cosine of x. Long double-precision floating-point version of cosh. 
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long double cosl( long double x ); 


Include MATH.H, ERRNO.H 

x Radians 

Returns The cosine of x if successful; 0 if x is so large that significance is 
completely lost 

errno ERANGE 


Calculates the cosine of x. Long double-precision floating-point version of cos. 
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int cprintf( char *format [[, argument]... ); 


Include CONIO.H 

format Format-control string 

argument Optional arguments 

Returns The number of characters printed 


Formats and prints to the console. See printf/scanf format table. 
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int cputs( char “string ); 


Include CONIO.H 
string Output string 
Returns 0 if successful; a nonzero value if not 


Writes a null-terminated string directly to the console. 
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escanf 


int creat( char *filename, int pmode ); 


Include SYS\TYPES.H, SYS\STAT.H, 10.H, ERRNO.H 
filename Path name of new file 

pmode S IWRITE, S_IREAD, S IREAD|S_IWRITE 
Returns A handle for the created file if successful; —1 if not 
errno EACCESS, EMFILE, ENOENT 


Creates a new file or opens and truncates an existing file. 
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int cscanf( char “format [[, argument]... ); 


Include CONIO.H 

format Format-control string 

argument Optional arguments 

Returns The number of fields that were successfully converted and assigned; 


EOF for an attempt to read at end-of-file 


Reads formatted data directly from the console into a specified location. See printf/scanf 
format table. 
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char “ctime( const time_t *timer ); 


Include TIME.H 
timer Pointer to stored time 
Returns A pointer to the character string result; NULL if timer represents a 


date before 1980 
Converts time stored as a time_t value to a character string. 
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int cwait( int *termstat, int procid, int action ); 


Include PROCESS.H, ERRNO.H 

termstat Termination status and return code 

procid Child process identification 

action WAIT CHILD, WAIT _ GRANDCHILD 

Returns The child process identification after normal termination; 
—1| otherwise 

errno EINTR, EINVAL, ECHILD 


Suspends the calling process until the child process terminates, and updates the termstat 
variable. 
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_ disable 
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dieeetomsbin 


difftime 


_disable 


int dieeetomsbin( double *s7cS, double *dsté ); 


Include MATH.H 

src& Buffer containing number to convert 

dst Buffer for converted number 

Returns 0 if the conversion is successful; 1 if the conversion causes an 
overflow 


Converts a double-precision number in IEEE format to Microsoft binary format. 
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double difftime( time_t timer/, time_t timer ); 


Include TIME.H 
timer1, timerO Time value structures defined in TIME.H 
Returns The difference between two times 


Computes the elapsed time in seconds between two time values. 
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void _disable( void ); 


Include DOS.H 


Returns No return value 


Disables interrupts by executing an 8086 CLI machine instruction. 
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_displaycursor 


div 


dmsbintoieee 


short far displaycursor( short toggle ); 


Include GRAPH.H 
toggle _GCURSOROFF, GCURSORON 
Returns The previous value of toggle 


Determines whether the cursor will be displayed. 
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div_t div( int numer, int denom ); 


Include STDLIB.H 

numer Numerator 

denom Denominator 

Returns The quotient and remainder in a structure defined in STDLIB.H 


Divides the numerator by the denominator computing the quotient and remainder. 
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int dmsbintoieee( double *s7c8, double *dsté ); 


Include MATH.H 

src8 Buffer containing number to convert 

dst8 Buffer for converted number 

Returns OQ if the conversion is successful; 1 if the conversion causes an 
overflow 


Converts a double-precision number in Microsoft binary format to IEEE format. 
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_dos_allocmem 


unsigned dos_allocmem( unsigned size, unsigned “seg ); 


Include DOS.H, ERRNO.H 

size Block size to allocate 

seg Segment descriptor return buffer 

Returns 0 if successful; the DOS error code if not 
errno ENOMEM 


Allocates a block of memory size paragraphs long (16 bytes each). 
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_dos_close 


unsigned dos_close( int handle ); 


Include DOS.H, ERRNO.H 

handle Target file handle 

Returns 0 if successful; the DOS error code if not 
errno EBADF 


Uses system call Ox3E to close a file. 
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_dos_creat 


unsigned dos creat( char *filename, unsigned attrib, int *handle ); 


Include 
filename 


attrib 


handle 
Returns 


errno 


DOS.H, ERRNO.H 
File path name 


_A ARCH, A HIDDEN, A NORMAL, A RDONLY, A SUBDIR, 
_A _SYSTEM, A _VOLID 


Handle return buffer 
O if successful; the DOS error code if not 


ENOENT, EMFILE, EACCESS, EEXIST 


Uses system call 0x3C to create a new file. 


O ANS! 


_dos_creatnew 
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unsigned dos_creatnew( char *filename, unsigned attrib, int *handle ); 


Include 
filename 


attrib 


handle 
Returns 


errno 


DOS.H, ERRNO.H 
File path name 


_A_ARCH, A HIDDEN, A NORMAL, A RDONLY, A SUBDIR, 
_A SYSTEM, _A_VOLID 


Handle return buffer 
0 if successful; the DOS error code if not 
ENOENT, EMFILE, EACCESS, EEXIST 


Uses system call OxSB to create a new file. 
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_dos_findfirst 


el 


dosexterr 


_dos_findfirst 


int dosexterr( struct DOSERROR “errorinfo ); 


Include 
errorinfo 


Returns 


DOS.H 
Error-information structure defined in DOS.H 


The value in the AX register (identical to the value in the exterror 
structure field) 


Uses system call 0x59 to get extended error information. 


O ANSI 
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unsigned _dos_findfirst( char “filename, unsigned attrib, struct find_t *fileinfo ); 


Include 
filename 


attrib 


fileinfo 
Returns 


errno 


DOS.H, ERRNO.H 
Target file name 


_A ARCH, A HIDDEN, A NORMAL, A_RDONLY, A SUBDIR, 
"A SYSTEM, A VOLID 


File-information return structure defined in DOS.H 
0 if successful; the DOS error code if not 


ENOENT 


Uses system call 0x4E to return information about the first instance of a file. 
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_dos_findnext 


_dos_freemem 


_dos_getdate 


unsigned dos_findnext( struct find_t */ileinfo ); 


Include DOS.H, ERRNO.H 

fileinfo File-information return structure defined in DOS.H 
Returns 0 if successful; the DOS error code if not 

errno ENOENT 


Uses system call 0x4F to find the next file that matches the name and attributes specified in 
a prior call to_dos_findfirst. 
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unsigned dos _freemem( unsigned seg ); 


Include DOS.H, ERRNO.H 

seg Block to be released 

Returns 0 if successful; the DOS error code if not 
errno ENOMEM 


Uses system call 0x49 to release a block of memory previously allocated by 
_dos_allocmem. 
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void dos _getdate( struct dosdate_t *date ); 


Include DOS.H 
date Current date structure defined in DOS.H 
Returns No return value 


Uses system call 0x2A to get the current system date. 
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_dos_getdrive 


_dos_getdisktree 


_dos_getdrive 


unsigned dos_getdiskfree( unsigned drive, struct diskfree_t “diskspace ); 


Include DOS.H, ERRNO.H 

drive Target disk drive 

diskspace Disk-information structure defined in DOS.H 
Returns 0 if successful; a nonzero value if not 

errno EINVAL 


Uses system call 0x36 to get information on a disk drive. 
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void dos _getdrive( unsigned “drive ); 


Include DOS.H 
drive Current drive return buffer 
Returns No return value 


Uses system call 0x19 to get the current disk drive (A: = 0, B: = 1). 
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_dos_getfileattr 


_dos_getftime 


unsigned dos _getfileattr( char “pathname, unsigned “attrib ); 


Include DOS.H, ERRNO.H 

pathname Full path of target file or directory 

attrib _A ARCH, A HIDDEN, A NORMAL, A RDONLY, A SUBDIR, 
_A SYSTEM, A VOLID 

Returns 0 if successful; the DOS error code if not 

errno ENOENT | 


Uses system call 0x43 to get the current attributes of a file or directory. 
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unsigned dos_getftime( int handle, unsigned *date, unsigned “time ); 


Include DOS.H, ERRNO.H 

handle Target file 

date Date-return buffer 

time Time-return buffer 

Returns 0 if successful; the DOS error code if not 
errno EBADF 


Uses system call 0x57 to get the time and date a file was last written. 
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_dos_keep 


_dos_gettime 


_dos_getvect 


_dos_keep 


void dos gettime( struct dostime_t “time ); 


Include DOS.H 
time Current system time structure defined in DOS.H 
Returns No return value 


Uses system call 0x2C to get the current system time. 
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void( interrupt far * dos_getvect( unsigned intnum ) )( ); 


Include DOS.H 
intnum Target interrupt vector 
Returns Far pointer to the current interrupt handler 


Uses system call 0x35 to get the current value of an interrupt vector. 
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void dos _keep( unsigned retcode, unsigned memsize ); 


Include DOS.H 

retcode Exit status code 

memsize Allocated resident memory in 16-byte paragraphs 
Returns No return value 


Uses system call 0x31 to install a terminate-and-stay-resident (TSR) program in memory. 
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_dos_open 


_dos_read 


unsigned dos open( char *filename, unsigned mode, int *handle ); 


Include 
filename 


mode 


handle 
Returns 


errno 


DOS.H, FCNTL.H, SHARE.H, ERRNO.H 
Path name to an existing file 


O _RDONLY, O_WRONLY, O_RDWR, SH_COMPAT, SH_DENYRW, 
SH_DENYWR, SH_DENYRD, SH DENYNO, O_NOINHERIT 


Handle-return buffer 
0 if successful; the DOS error code if not 


EINVAL, ENOENT, EMFILE, EACCESS 


Uses system call 0x3D to open an existing file, with modes specified by mode. 
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unsigned dos_read( int handle, void far *buffer, unsigned count, unsigned “numread ); 


Include 
handle 
buffer 
count 
numread 
Returns 


errno 


DOS.H, ERRNO.H 

File to read 

Buffer to write to 

Number of bytes to read 

Number of bytes actually read 

0 if successful; the DOS error code 1f not 


EACCESS, EBADF 


Uses system call Ox3F to read data from a file. 
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_dos_setdate 


_dos_setblock 


_dos_setdate 


unsigned dos_setblock( unsigned size, unsigned seg, unsigned *maxsize ); 


Include DOS.H, ERRNO.H 

size New segment size 

seg Target segment 

maxsize Maximum size buffer 

Returns O if successful; the DOS error code if not 
errno ENOMEM 


Changes the size of a segment previously allocated by dos _allocmem. 
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unsigned dos_setdate( struct dosdate_t “date ); 


Include DOS.H, ERRNO.H 

date System date structure defined in DOS.H 
Returns O if successful; a nonzero value if not 
errno EINVAL 


Uses system call 0x2B to set the current system date. 
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_dos_setdrive 


void dos_setdrive( unsigned drive, unsigned “numdrives ); 


Include DOS.H 

drive New default drive 
numdrives Total drives available 
Returns No return value 


Uses system call OxOE to set the current default drive. 
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_dos_setfileattr 


unsigned dos setfileattr( char *pathname, unsigned attrib ); 


Include DOS.H, ERRNO.H 

pathname Full path of target file or directory 

attrib | _A ARCH, A HIDDEN, A NORMAL, A RDONLY, A SUBDIR, 
_A SYSTEM, A VOLID 

Returns 0 if successful; the DOS error code if not 

errno EACCESS, ENOENT 


Uses system call 0x43 to set the attributes of a file or a directory. 
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_dos_settime 
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_dos_setftime 


_dos_settime 


unsigned dos_setftime( int iandle, unsigned date, unsigned time ); 


Include DOS.H, ERRNO.H 

handle Target file 

date Date of last write 

time Time of last write 

Returns 0 if successful; the DOS error code if not 
errno EBADF 


Uses system call 0x57 to set the date and time a file was last written. 
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unsigned dos_settime( struct dostime_t *time ); 


Include DOS.H, ERRNO.H 

time System time structure defined in DOS.H 
Returns 0 if successful; a nonzero value if not 
errno EINVAL 


Uses system call 0x2D to set the current system time. 
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_dos_setvect 


_dos_write 


void dos setvect( unsigned intnum, void( interrupt far “handler )() ); 


Include DOS.H 

intnum Target interrupt vector 
handler Interrupt handler to assign 
Returns No return value 


Uses system call 0x25 to set the current value of an interrupt vector. 
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unsigned dos _write( int handle, void _far *buffer, unsigned count, unsigned “numwrt ); 


Include DOS.H, ERRNO.H 

handle File to write to 

buffer Buffer to write from 

count Number of bytes to write 

numwrt Number of bytes actually written 
Returns 0 if successful; the DOS error code if not 
errno EACCESS, EBADF 


Uses system call 0x40 to write data to a file. 
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dup2 


int dup( int handle ); 


Include 
handle 
Returns 


errno 


dup2 


10.H, ERRNO.H 
Handle of an open file 
A new file handle if successful; —1 if not 


EBADF, EMFILE 


Associates a second file handle with the currently open file. 
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int dup2( int handle/, int handle? ); 


Include 
handle! 
handle2 
Returns 


errno 


10.H, ERRNO.H 
Handle of an open file 
Any handle value 

0 if successful; —1 if not 


EBADF, EMFILE 


Associates the specified second handle with the currently open file. 
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char *ecvt( double value, int count, int “dec, int *sign ); 


Include 
value 
count 
dec 
sign 


Returns 


STDLIB.H 

Number to be converted 
Number of digits stored 
Stored decimal-point position 
Sign of converted number 


A pointer to the string of digits 


Converts a floating-point number to a character string. 
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short far ellipse( short control, short x/, short y/, short x2, short y2 ); 


Include 
control 
xl, yl 
x2, y2 


Returns 


GRAPH.H 

_GFILLINTERIOR, GBORDER 

Upper left corner of bounding rectangle 
Lower right corner of bounding rectangle 


A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws an ellipse using view coordinates. 
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_ellipse_wxy 
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_eéllipse_w 


_@llipse_wxy 


Short far _ellipse_w( short control, double wx/, double wy/, double wx2, double wy2 ); 


Include GRAPH.H 

control _GFILLINTERIOR, GBORDER 

wxl, wyl Upper left corner of bounding rectangle 

wx2, wy2 Lower right corner of bounding rectangle 

Returns A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws an ellipse using window coordinates. 


O ANS! M@ DOS OOS/2 OUNIX OC XENIX 


Short far ellipse_wxy( short control, struct wxycoord far *pwxy/, 
struct wxycoord far *pwxy2 ); 


Include GRAPH.H 

control _GFILLINTERIOR, GBORDER 

pwxyl Upper left corner of bounding rectangle 
pwxy2 Lower right corner of bounding rectangle 
Returns A nonzero value if successful; 0 if not 


Draws an ellipse using window coordinates. 
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_ enable 


_endthread 


eof 


void _enable( void ); 


Include DOS.H 


Returns No return value 


Enables interrupts by executing an 8086 STI machine instruction. 
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void far endthread( void ); 


Include PROCESS.H 


Returns No return value 


Terminates a thread created by _beginthread. 
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int eof( int handle ); 

Include IO.H, ERRNO.H 

handle Handle referring to open file 

Returns 1 if the current position is end-of-file; 0 if not; —1 if an error has 
occurred 

errno EBADF 


Determines whether the end of the file has been reached. 
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exec! 
int execl( char *cmdname, char *arg0, ... char “argn, NULL); 
Include PROCESS.H, ERRNO.H 
cmdname Path name of file to be executed 
arg0, ... argn List of pointers to arguments, terminated by NULL 
Returns | Does not normally return to the calling process, but if it does, an 
error has occurred and the return value is —1 
errno E2BIG, EACCESS, EMFILE, ENOENT, ENOEXEC, ENOMEM 
Loads and executes a new child process, terminating the calling process. Command-line 
arguments are passed individually. 
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int execle( char *cmdname, char *arg0, ... char “argn, NULL, char **eonyp )s 


Include PROCESS.H, ERRNO.H 

cmdname Path name of file to be executed 

arg0, ... argn List of pointers to arguments, terminated by NULL 

envp Array of pointers to environment settings 

Returns Does not normally return to the calling process, but if it does, an 
error has occurred and the return value is —1 

errno E2BIG, EACCESS, EMFILE, ENOENT, ENOEXEC, ENOMEM 


Loads and executes a new child process, terminating the calling process. Command-line 
arguments are passed individually. An array of pointers to environment arguments is 
explicitly passed to the child process. 
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int execlp( char “cmdname, char *arg0, ... char “argn, NULL); 


Include PROCESS.H, ERRNO.H. 

cmdname Path name of file to be executed 

arg0, ... argn List of pointers to arguments, terminated by NULL 

Returns Does not normally return to the calling process, but if it does, an 
error has occurred and the return value is —1 

errno E2BIG, EACCESS, EMFILE, ENOENT, ENOEXEC, ENOMEM 


Loads and executes a new child process, terminating the calling process. Command-line ar- 
guments are passed individually. Uses the PATH environment variable to find the file to be 
executed. 
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int execlpe( char *cmdname, char *arg0, ... char *argn, NULL, char **onyp )5 


Include PROCESS.H, ERRNO.H 

cmdname Path name of file to be executed 

arg0, ... argn List of pointers to arguments, terminated by NULL 

envp Array of pointers to environment settings 

Returns Does not normally return to the calling process, but if it does, an 
error has occurred and the return value is —1 

errno E2BIG, EACCESS, EMFILE, ENOENT, ENOEXEC, ENOMEM 


Loads and executes a new child process, terminating the calling process. Command-line ar- 
guments are passed individually. Uses the PATH environment variable to find the file to be 
executed. An array of pointers to environment arguments is explicitly passed to the child 
process. 
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exéecve 


EXECVE 


int execv( char *cmdname, char **argyv ); 


Include PROCESS.H, ERRNO.H 

cmdname Path name of file to be executed 

argv Array of pointers to arguments 

Returns Does not normally return to the calling process, but if it does, an 
error has occurred and the return value is —1 

errno E2BIG, EACCESS, EMFILE, ENOENT, ENOEXEC, ENOMEM 


Loads and executes a new child process, terminating the calling process. Command-line 
arguments are passed as an array of pointers. 


O ANS! @ DOS 8 OS/2 MUNIX” i XENIX 


int execve( char *cmdname, char **argv, char **envp ); 


Include PROCESS.H, ERRNO.H 

cmdname Path name of file to be executed 

argv Array of pointers to arguments 

envp Array of pointers to environment settings 

Returns Does not normally return to the calling process, but if it does, an 
error has occurred and the return value is —1 

errno E2BIG, EACCESS, EMFILE, ENOENT, ENOEXEC, ENOMEM 


Loads and executes a new child process, terminating the calling process. Command-line ar- 
guments are passed as an array of pointers. An array of pointers to environment arguments 
is explicitly passed to the child process. 


OANS| @ DOS 8 OS/2 M UNIX” BB XENIX 


execvp 186 


$255 ah me NP TET PE EE TB EE EE EE PO 


EXecVvp 
int execvp( char *cmdname, char **argyv ); 
Include PROCESS.H, ERRNO.H 
cmdname Path name of file to be executed 
argv Array of pointers to arguments 
Returns Does not normally return to the calling process, but if it does, an 
error has occurred and the return value is —1 
errno E2BIG, EACCESS, EMFILE, ENOENT, ENOEXEC, ENOMEM 
Loads and executes a new child process, terminating the calling process. Command-line 
arguments are passed as an array of pointers. Uses the PATH environment variable to find 
the file to be executed. 
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int execvpe( char *cmdname, char **argy, char **envp ); 
9 9 9 


Include PROCESS.H, ERRNO.H 

cmdname Path name of file to be executed 

argv Array of pointers to arguments 

envp Array of pointers to environment settings 

Returns Does not normally return to the calling process, but if it does, an 
error has occurred and the return value is —1 

errno E2BIG, EACCESS, EMFILE, ENOENT, ENOEXEC, ENOMEM 


Loads and executes a new child process, terminating the calling process. Command-line ar- 
guments are passed as an array of pointers. Uses the PATH environment variable to find the 
file to be executed. An array of pointers to environment arguments is explicitly passed to 
the child process. 
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exp 


void exit( int status ); 


Include PROCESS.H or STDLIB.H 
Status Exit status 
Returns No return value 


Terminates a process after normal cleanup operations (e.g., flushing buffers). 
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void _exit( int status ); 


Include PROCESS.H or STDLIB.H 
Status Exit status 
Returns No return value 


Terminates a process without normal cleanup operations. 
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double exp( double x ); 

Include MATH.H, ERRNO.H 

x Floating-point value 

Returns Exponential function of x if successful; 0 on underflow; HUGE_VAL 
on overflow 

errno ERANGE 


Returns the exponential function of the floating-point argument x. 
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void * expand( void *memblock, size_t size ); 


Include MALLOC.H 

memblock Pointer to previously allocated memory block 

size New size in bytes 

Returns A pointer to the resized memory block; NULL if there is insufficient 


memory to expand the block 


Changes the size of a previously allocated memory block by attempting to expand or con- 
tract the block without moving its location in the heap. 
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long double expl( long double x ); 


Include MATH.H, ERRNO.H 

x Long double-precision floating-point value 

Returns Exponential function of x if successful; 0 on underflow; 
_LHUGE_VAL on overflow 

errno ERANGE 


Returns the exponential function of the floating-point argument x. Long double-precision 
floating-point version of exp. 
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fabs! 


_fealloc 


_fealloc 


double fabs( double x ); 

Include MATH.H 

x Floating-point value 
Returns The absolute value of x 


Gets the absolute value of a double-precision floating-point value. 
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long double fabsl( long double x ); 


Include MATH.H 
x Long double-precision floating-point value 
Returns The absolute value of x 


Gets the absolute value of a long double-precision floating-point value. 
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void far * fcalloc( size_t num, size_t size ); 


Include MALLOC.H 

num Number of elements 

size Length in bytes of each element 

Returns A far pointer to the allocated space if successful; NULL if there is in- 


sufficient memory available 
Allocates storage space for an array in the far heap. 
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fclose 


feloseall 


fevt 


int fclose( FILE “stream ); 


Include STDIO.H 
stream Target stream 
Returns 0 if the stream is successfully closed; EOF if not 


Closes an open stream. 
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int fcloseall( void ); 


Include STDIO.H 


Returns The total number of streams closed; EOF if an error occurs 


Closes all open streams. 
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char *fcvt( double value, int count, int *dec, int *sign ); 


Include STDLIB.H 

value Number to be converted 

count Number of digits after decimal point 
dec Pointer to stored decimal-point position 
sign Pointer to stored sign indicator 

Returns A pointer to the string of digits 


Converts a floating-point number to a character string. 
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feof 


ferror 


ferror 


FILE *fdopen( int handle, char *mode ); 


Include STDIO.H 

handle Handle of open file 

mode Access permissions: AT ded Wyytt Walt ng a i Wey! A fi wht 
Returns A pointer to the open stream if successful; NULL if not 


Associates a stream with a file handle, allowing a file opened for low-level I/O to be 
buffered and formatted. 
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int feof( FILE *stream ); 


Include STDIO.H 
stream Pointer to a stream 
Returns A nonzero value after the first read operation that attempts to read 


past the end of the file; 0 if the current position is not end-of-file 
Determines whether the end of stream has been reached. 
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int ferror( FILE “stream ); 


Include STDIO.H 
stream Pointer to a stream 
Returns A nonzero value if an error occurred; O 1f not 


Tests for a reading or writing error on stream. 
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_fexpand 


fflush 


_ffree 


void far * fexpand( void far *memblock, size_t size ); 


Include MALLOC.H 

memblock Pointer to previously allocated memory 

size New size in bytes 

Returns A far pointer to the resized memory block if successful; NULL if not 


Changes the size of a block in the far heap. 
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int fflush( FILE *stream ); 


Include STDIO.H 
stream Pointer to target stream 
Returns 0 if successful or where the specified stream has no buffer or is open 


for reading only; EOF otherwise 
Writes the contents of the buffer associated with the stream to the associated file. 
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void ffree( void far *memblock ); 


Include MALLOC.H 
memblock Allocated memory block in the far heap 
Returns No return value 


Frees a memory block in the far heap. 
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fgetpos 


fgetpos 


int fgetc( FILE *stream ); 


Include STDIO.H 
stream Pointer to target stream 
Returns The character read; EOF if an error occurred or at end-of-file 


Reads a character from stream. 
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int fgetchar( void ); 
Include STDIO.H 
Returns The character read; EOF if an error occurred or at end-of-file 


Reads a character from the standard input stream, stdin. 
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int fgetpos( FILE *stream, fpos_t “pos ); 


Include STDIO.H, ERRNO.H 

stream Pointer to target stream 

pos Position-indicator buffer 

Returns 0 if successful; a nonzero value if not 
errno EBADF, EINVAL 


Gets the current value of the stream file-position indicator. 
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char “fgets( char *string, int n, FILE *stream ); 


Include STDIO.H 

string Storage location for data 

n Maximum number of characters read and stored 

stream Pointer to target stream 

Returns string if successful; NULL to indicate an error or end-of-file 


Reads a string of, at most, characters from the input stream and stores it in string. 
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int fheapchk( void ); 


Include MALLOC.H 
Returns _HEAPOK, HEAPEMPTY, HEAPBADBEGIN, 
_HEAPBADNODE 


Checks for minimal consistency in the far heap. 
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int fheapmin( void ); 


Include MALLOC.H 


Returns 0 if successful; —1 if not 


Releases unused memory in the far heap back to the operating system. 
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_fheapset 


_fheapwalk 


int fheapset( unsigned int /i// ); 


Include MALLOC.H 

fill Fill character 

Returns _HEAPOK, HEAPEMPTY, HEAPBADBEGIN, 
_HEAPBADNODE 


Checks for minimal consistency in the far heap and then sets the heap’s free entries with the 
fill value. 
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int fheapwalk( HEAPINFO *entryinjo ); 


Include MALLOC.H 

entryinfo Structure to contain information about the next far heap entry, 
defined in MALLOC.H 

Returns _HEAPOK, HEAPEMPTY, HEAPBADPTR, 


_HEAPBADBEGIN, HEAPBADNODE, HEAPEND 


Walks through the far heap, one entry per call, returning a pointer to a_HEAPINFO struc- 
ture that contains information about the next far heap entry. 
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fieeetomsbin 


filelength 


fileno 


int fieeetomsbin( float *src4, float *dst4 ); 


Include MATH.H 

src4 Value to convert 

dst4 Buffer for converted value 

Returns O if successful; 1 1f the conversion causes an overflow 


Converts a single-precision floating-point number in IEEE format to Microsoft binary 
format. 
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long filelength( int handle ); 


Include 1O.H, ERRNO.H 

handle Target file handle 

Returns The file length in bytes if successful; —1 if not 
errno EBADF 


Gets the length in bytes of a file. 
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int fileno( FILE “stream ); 


Include STDIO.H 
stream Pointer to target stream 
Returns The file handle 


Returns the file handle currently associated with stream. 


OANS| @ DOS #8 OS/2 MUNIX” Wt XENIX 


197 


_floodfill_w 


_floodfill 


_floodfill_w 


short far floodfill( short x, short y, short boundary ); 


Include GRAPH.H 

x,y Starting point 

boundary Fill boundary color 

Returns A nonzero value if successful; 0 if the fill could not be completed, 


the starting point lies on the boundary color, or the starting point lies 
outside the clipping region 


Fills an area of the display beginning at the view coordinate point using the current color 
and fill mask. 
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short far floodfill_w( double wx, double wy, short boundary ); 


Include GRAPH.H 

WX, Wy Starting point 

boundary Fill boundary color 

Returns A nonzero value if successful; 0 if the fill could not be completed, 


the starting point lies on the boundary color, or the starting point lies 
outside the clipping region 


Fills an area of the window using the current color and fill mask. 
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double floor( double x ); 


Include MATH.H 
x Floating-point value 
Returns The floating-point result 


Returns a floating-point value representing the largest integer that is less than or equal to x. 
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long double floorl( long double x ); 


Include MATH.H 
x Long double-precision floating-point value 
Returns Long double-precision floating-point result, rounded down 


Returns a long double-precision floating-point value representing the largest integer that is 
less than or equal to x. 
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int flushall( void ); 
Include STDIO.H 
Returns The number of open streams 


Writes the contents of all buffers for open output streams to their files and clears all buffers 
for open input streams of their contents. 
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_fmemecpy 
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_fmalloe 


_fmemccpy 


void far * fmalloc( size_t size ); 


Include MALLOC.H 
size Number of bytes to allocate 
Returns A far pointer to the allocated space; NULL if it fails 


Allocates a memory block of at least size bytes in the far heap. 
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void far * far fmemecpy( void far *dest, void _far “src, int c, unsigned int count ); 


Include STRING.H or MEMORY.H 

dest Far pointer to destination 

STC Far pointer to source 

C Last character to copy 

count Number of characters 

Returns A far pointer to the byte in dest that immediately follows the copied 
peor (c) if successful; NULL if count bytes copied before c was 


Copies zero or more far bytes of src to dest, copying up to and including the first occur- 
rence of the character c or until count bytes have been copied, whichever comes first. 
Model-independent version of memccpy. 
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_fmemehr 
void far * far fmemchr( const void far “buf, int c, size_t count ); 
Include STRING.H or MEMORY.H 
buf Far pointer to buffer 
C Character to copy 
count Number of characters 
Returns A far pointer to the first location of c in buf if successful; NULL 
if not 
Looks for the first occurrence of c in the first count bytes of buf. Model-independent ver- 
sion of memcehr. 
OANS| @ DOS @OS/2 OUNIX' OC XENIX 
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int far fmemcmp( const void far *bufl, const void far *buf2, size_t count ); 


Include STRING.H or MEMORY.H 

buf1, buf2 Far pointers to buffers to compare 

count Number of characters 

Returns A value less than, equal to, or greater than 0, depending on whether 


the size of the buffer pointed to by buf! is less than, equal to, or 
greater than the size of the buffer pointed to by buf2 


Compares the first count bytes of two buffers and returns a value indicating their relation- 
ship. Model-independent version of memcmp. 
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_fmemicmp 
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_fmemcpy 


_fmemicmp 


void far * far _fmemepy( void far *dest, const void _far “src, size_t count ); 


Include STRING.H or MEMORY.H 

dest Far pointer to the destination buffer 
STC Far pointer to the buffer to copy from 
count Number of characters to copy 
Returns dest 


Copies count bytes of src to dest. Model-independent version of memcpy. 
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int far fmemicmp( void _far *bufl, void _far *buf2, unsigned int count ); 


Include STRING.H or MEMORY.H 
buf1, buf2 Far pointers to buffers to compare 
count Number of characters 
Returns A value less than, equal to, or greater than 0, depending on whether 


the size of the buffer pointed to by buf is less than, equal to, or 
greater than the size of the buffer pointed to by buf2 


Compares a specified number of characters from two buffers without regard to letter case. 
Model-independent version of memicmp. 
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void far* far fmemmove( void far *dest, const void far “src, size_t count ); 


Include STRING.H 

dest Far pointer to destination buffer 
STC Far pointer to source buffer 
count Number of characters to copy 
Returns The value of dest 


Copies count characters from src to dest. Model-independent version of memmove. 
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void _far* far fmemset( void far “dest, int c, size_t count ); 


Include STRING.H or MEMORY.H 
dest Far pointer to destination 

C Character to set 

count Number of characters 
Returns A far pointer to dest 


Sets the first count bytes of dest to the character c. Model-independent version of memset. 
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fmsbintoieee 


fmsbintoleee 


double fmod( double x, double y ); 


Include MATH.H 
ay Floating-point values 
Returns The floating-point remainder 


Calculates the floating-point remainder f of (x, y) such that x =i * y + f, where / is an in- 
teger, f has the same sign as x, and the absolute value of fis less than the absolute value of y. 
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long double fmodl( long double x, long double y ); 


Include MATH.H 
x,y Floating-point values 
Returns The floating-point remainder 


Calculates the long double-precision floating-point remainder f of (x, y) such that 
x=i* y +f, where i is an integer, fhas the same sign as x, and the absolute value of fis less 
than the absolute value of y. Long double-precision floating-point version of fmod. 
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int fmsbintoieee( float *src4, float *dst4 ); 


Include MATH.H 

src4 Value to convert 

dst4 Buffer for converted value 

Returns 0 if successful; 1 if the conversion causes an overflow 


Converts a floating-point number in Microsoft binary format to IEEE format. 
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_fmsize 


fopen 


FP_OFF 


size_t _fmsize( void far “memblock ); 


Include MALLOC.H 
memblock Pointer to far memory block 
Returns An unsigned integer representing the size in bytes of the far-heap 


memory block allocated by a call to _fcalloc, fmalloc, or _frealloc 
Returns the size of the memory block pointed to by memblock. 
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FILE *fopen( const char *filename, const char *mode ); 


Include STDIO.H 
filename Path name of file 
mode Access permissions: "r", "r+", "r+b", "r+t", "w"", "w+", "w+b", 


"wt", wares "at", "a+b", ee eS 


Returns A pointer to the open file if successful; NULL if not 


Opens a specified file for stream I/O. 
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unsigned FP_OFF( void _far “address ); 


Include DOS.H 
address Far pointer to memory address 
Returns An offset 


Sets or gets the offset portion of a far address. 
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_fpreset 
void _fpreset( void ); 
Include FLOAT.H 
Returns No return value 
Reinitializes the floating-point math package. 
O ANS! @ DOS W@ OS/2 OUNIX OC XENIX 
fprintt 
int fprintf( FILE *stream, const char *format [, argument]... ); 
Include STDIO.H 
stream Pointer to target stream 
format Format-control string 
argument Optional arguments 
Returns The number of characters printed if successful; a negative value if not 
Formats and prints a series of characters and values to the output stream. 
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FP_SEG 


unsigned FP_SEG( void _far “address ); 


Include DOS.H 
address Far pointer to memory address 
Returns A segment 


Sets or gets the segment selector portion of a far address. 
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foutc 


fputchar 


fputs 


int fpute( int c, FILE “stream ); 


Include STDIO.H 

C Character to be written 

stream Pointer to target stream 

Returns The character written if successful; EOF if not 


Writes a single character to the target stream. 
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int fputchar( int c ); 

Include STDIO.H 

C Character to be written 

Returns The character written if successful; EOF if not 


Writes a single character to the standard output stream, stdout. 
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int fputs( const char “string, FILE *stream ); 


Include STDIO.H 

string Output string 

stream Pointer to target stream 

Returns A nonnegative value if successful; EOF if not 


Copies a string to the target stream. 
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_frealloc 


size_t fread( void *bu/ffer, size_t size, size_t count, FILE *stream ); 


Include 
buffer 
Size 
count 
stream 


Returns 


STDIO.H 

Storage location for data 

Item size in bytes 

Maximum number of items to be read 
Pointer to target stream 


The number of items actually read, which may be less than count if 
an error occurs 


Reads up to count items of size bytes from the input stream and stores them in buffer. 


m@ ANSI 
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void far * frealloc( void far *memblock, size_t size ); 


Include 
memblock 
S1Ze 


Returns 


MALLOC.H 
Pointer to previously allocated far memory block 
New size in bytes 


A far pointer to the reallocated memory block if successful; NULL 
if not 


Changes the size of a previously allocated far memory block, possibly moving it. 
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void free( void *memblock ); 


Include STDLIB.H, MALLOC.H 
memblock Allocated memory block 
Returns No return value 


Frees a memory block previously allocated by calloc, malloc, or realloc. 
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unsigned int freect( size_t size ); 


Include MALLOC.H 
size Item size in bytes 
Returns The number of items that can be allocated in the near heap 


Determines how much memory is available for dynamic memory allocation in the near 
heap by returning the number of times an item can be allocated. 
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freopen 
FILE *freopen( const char *filename, const char *mode, FILE *stream ); 
Include STDIO.H 
filename Path name of new file 
mode Access permission: "r", "r+", "r+b", "r+t", "w">, "we", "w+b", 
ae : Wot! ; Noun ; Nab" : a 
stream Pointer to target stream | 
Returns A pointer to the newly opened file if successful; NULL if not 
Closes the file currently associated with stream and reassigns stream to the file specified by 
filename. 
MANS! @ DOS 8 OS/2 BM UNIX” lf XENIX 
frexp 


double frexp( double x, int *expptr ); 


Include MATH.H 

x Floating-point value 

expptr Pointer to stored integer exponent 
Returns The mantissa if successful; 0 if x is O 


Breaks down the floating-point value (x) into a mantissa (m) and an exponent (n) such that 
the absolute value of m is greater than or equal to 0.5 and less than 1.0, and x =m * 2”, 
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long double frexpl( long double x, int *expptr ); 


Include MATH.H 

x Long double-precision floating-point value 
expptr Pointer to stored integer exponent 

Returns The mantissa if successful; 0 if x is O 


Breaks down the long double-precision floating-point value (x) into a mantissa (77) and an 
exponent () such that the absolute value of m is greater than or equal to 0.5 and less than 
1.0, and x = m * 2”. Long double-precision floating-point version of frexp. 
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int fscanf( FILE “stream, const char *format [, argument]... ); 


Include STDIO.H 

stream Pointer to target stream 

format Format-control string 

argument Optional arguments 

Returns The number of fields that were successfully converted and assigned, 


or EOF for end-of-file 
Reads data from the current position of stream into the locations given by argument (if any). 
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fseek 


fsetpos 


int fseek( FILE *stream, long offset, int origin ); 


Include STDIO.H 

stream Pointer to target stream 

offset Number of bytes from origin 

origin Initial position: SEEK_CUR, SEEK_END, SEEK_SET 
Returns 0 if successful; a nonzero value if not 


Moves the file-position indicator associated with stream to a new location that is offset 
bytes from origin. It has limited use in text mode. 
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int fsetpos( FILE *stream, const fpos_t *pos ); 


Include STDIO.H, ERRNO.H 

stream Pointer to target stream 

pos Position-indicator storage 

Returns 0 if successful; a nonzero value if not 
errno EBADF, EINVAL 


Sets the file-position indicator for stream to the value of pos. 
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FILE * fsopen( const char *filename, const char *mode, int shflag ) 


Include STDIO.H, SHARE.H 

filename File path name 

mode Access permissions: "r", "r+", "r+b", "r+t", "w", "w+", "w+b", 
"wit" d Wot : " a+" ; " a+b", es 

shflag SH_COMPAT, SH_DENYRW, SH_DENYWR, SH_DENYRD, 
SH DENYNO 

Returns A pointer to the stream if successful; NULL if not 


Opens a file as a stream and prepares it for shared reading and writing. 
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int fstat( int handle, struct stat *buffer ); 


Include SYS\TYPES.H, SYS\STAT.H, ERRNO.H 
handle Handle of open file 

buffer Pointer to structure to store results 
Returns 0 if successful; —1 if not 

errno EBADF 


Gets information about the open file associated with handle and stores it in the structure 
that buffer points to. 
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_fstreat 
char far* far fstrceat( char far *string/, const char far *string2 ); 
Include STRING.H 
string] Far pointer to destination string 
string2 Far pointer to source string 
Returns A far pointer to the concatenated string 
Appends string2 to string]. Model-independent version of strcat. 
OANS| @ DOS WOS/2 OUNIX' OC XENIX 
_fstrehr 
char far* far _fstrchr( const char far “string, int c ); 
Include STRING.H 
string Far pointer to source string 
G Character to be located 
Returns A far pointer to the first occurrence of c in string 
Searches for the first occurrence of c in string. Model-independent version of strcehr. 
O ANS! @ DOS #8 OS/2 OUNIX OF XENIX 
_fstremp 


int far fstremp( const char far *string/, const char far “string2 ); 


Include STRING.H 
string], string2 Far pointers to strings to compare 
Returns A value less than 0 if string! < string2; 0 if stringl = string2; a value 


greater than 0 if string/ > string2 
Compares two strings. Model-independent version of strcmp. 
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char far* far fstrepy( char far *string/, const char far *string2 ); 


Include STRING.H 

string] Far pointer to destination string 
string2 Far pointer to source string 
Returns string] 


Copies string2 to string!. Model-independent version of strepy. 
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size t far fstrespn( const char far “string/, const char far “string2 ); 


Include STRING.H 

string] Far pointer to source string 

string2 Far pointer to character set 

Returns The index of the first character in string/ that belongs to the set of 


characters specified by string2 


Finds first substring in string] consisting of characters not in string2. Model-independent 
version of strespn. 
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fstrilen 


sme 


_fstrdup 


_fstricmp 


_fstrlen 


char far * far _fstrdup( const char far *string ); 


Include STRING.H 
string Far pointer to source string 
Returns A far pointer to the storage space containing the duplicate string 


Duplicates string, copying it to memory allocated by _fmalloc. Model-independent 
version of strdup. 
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int far fstricmp( const char far *string1, const char far “string2 ); 


Include STRING.H 
string], string2 Far pointers to strings to compare 
Returns A value less than 0 if string! < string2; 0 if string] = string2; a value 


greater than 0 if string] > string2 
Compares two strings without regard to case. Model-independent version of stricmp. 
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size t_fstrlen( const char far *string ); 


Include STRING.H 
string Far pointer to null-terminated string 
Returns The length in bytes of string, not including the terminating null 


character (’\0’) 
Finds length of string. Model-independent version of strlen. 
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_fstrncat 
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char far * far_fstrlwr( char far “string ); 


Include STRING.H 
string Far pointer to string to be converted 
Returns A far pointer to the converted string 


Converts any uppercase letters in the given null-terminated string to lowercase. Other char- 
acters are not affected. Model-independent version of strIwr. 
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char far * far _fstrneat( char far *string/, const char _far *string2, size_t count )3 


Include STRING.H 

string] Far pointer to destination string 

string2 Far pointer to source string 

count Number of characters appended 
Returns A far pointer to the concatenated string 


Appends, at most, the first count characters of string2 to string] and terminates the result- 
ing string with a null character (’\0’). Model-independent version of strneat. 
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_fstrncepy 
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_fstrnemp 


_fstrnepy 


int far _fstrncmp( const char far *string], const char far *string2, size_t count ); 


Include STRING.H 

string], string2 Far pointers to strings to compare 

count Number of characters compared 

Returns A value less than 0 if string! < string2; 0 if string] = string2; a value 


greater than Oif string] > string2 


Compares, at most, the first count characters of string] and string2. Model-independent 
version of strnemp. 
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char _far* far _fstrnepy( char _far *string/, const char _far “string2, size_t count ); 


Include STRING.H 

string] Far pointer to destination string 
string2 Far pointer to source string 
count Number of characters copied 
Returns string 


Copies exactly count characters of string2 to string]. Model-independent version of 
strncpy. 
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_fstrnicmp 


_fstrnset 


int far fstrnicmp( const char far *string/, const char far *string2, size_t count ); 


Include STRING.H 

string], string2 Far pointers to strings to compare 

count Number of characters compared 

Returns A value less than 0 if string] < string2; 0 if string] = string2; a value 


greater than 0 if string! > string2 


Compares, at most, the first count characters of string] and string2, without regard to letter 
case. Model-independent version of strnicmp. 
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char far* far fstrnset( char far *string, int c, size_t count ); 


Include STRING.H — 

string Far pointer to string to be initialized 
C Character setting 

count Number of characters set 

Returns A far pointer to the altered string 


Sets, at most, the first count characters of string to the character c. Model-independent 
version of strnset. 
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_fstrpbrk 
char far* far fstrpbrk( const char far *stringl, const char far *string2 ); 
Include STRING.H 
string] Far pointer to source string 
string2 Far pointer to character set 
Returns A far pointer to the first occurrence of any character from string2 in 
string] 
Finds the first occurrence of a character from one string in another. Model-independent 
version of strpbrk. 
O ANS! @ DOS @ OS/2 OUNIX CO XENIX 
_fstrrehr 


char far* far _fstrrchr( const char far “string, int c ); 


Include STRING.H 

string Far pointer to searched string 

C Character to be located 

Returns A far pointer to the last occurrence of c in string 


Finds the last occurrence of a given character in a string. Model-independent version of 
strrehr. 
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_fstrrev 
char far * far _fstrrev( char far “string ); 
Include STRING.H 
string Far pointer to string to be reversed 
Returns A far pointer to the altered string 
Reverses the order of the characters in string. The terminating null character (’\0’) remains 
in place. Model-independent version of strrev. 
O ANS! m DOS mOS/2 OUNIX © XENIX 
_fstrset 


char far * far fstrset( char far *string, int c ); 


Include STRING.H 

string Far pointer to string to be set 

C Far pointer to character setting 
Returns A far pointer to the altered string 


Sets all of the characters of string to c, except the terminating null character (’\0’). Model- 
independent version of strset. 
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_fstrstr 


_fstrspn 


_fstrstr 


size_t far fstrspn( const char far “string/, const char far *string2 ); 


Include STRING.H 

string] Far pointer to searched string 

string2 Far pointer to character set 

Returns An integer value specifying the length of the segment in string] con- 


sisting entirely of characters in string2 


Returns the index of the first character in string] that does not belong to the set of charac- 
ters specified by string2. This value is equivalent to the length of the initial substring of 
string] that consists entirely of characters from string2. Model-independent version of 
strspn. 
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char far* far fstrstr( const char far *string], const char far *string2 ); 


Include STRING.H 

string] Far pointer to searched string 

string2 Far pointer to string to search for 

Returns A far pointer to the first occurrence of string2 in string] 


Finds the first occurrence of a given string in another string. Model-independent version of 
strstr. 
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_fstrtok 
char far * far fstrtok( char far *string/, const char _far “string2 ); 
Include STRING.H 
string] Far pointer to string containing token(s) 
string2 Far pointer to set of delimiter characters 
Returns A far pointer to the first token in string/; successive calls against the 
same string return the subsequent tokens in the string 
Reads string] as a series of zero or more tokens and string2 as the set of characters serving 
as delimiters of the tokens in string]. Model-independent version of strtok. 
O ANS! m@ DOS 8 OS/2 OUNIX OC XENIX 
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char far* far _fstrupr( char _far *string ); 


Include STRING.H 
string Far pointer to string to be capitalized 
Returns A far pointer to the converted string 


Converts any lowercase letters in string to uppercase. Other characters are not affected. 
Model-independent version of strupr. 


O ANS! @ DOS W@OS/2) OUNIX CO XENIX 


223 ftime 


ftell 
long ftell( FILE “stream ); 
Include STDIO.H, ERRNO.H 
stream Pointer to target stream 
Returns The current position if successful; —1L if not 
errno EBADF, EINVAL 
Gets the current position of the file-position indicator associated with stream. Use with 
fseek. 
MANS! @ DOS 8 OS/2 HM UNIX” Wf XENIX 
ftime 


void ftime( struct timeb “timeptr ); 


Include SYS\TYPES.H, SYS\TIMEB.H 
timeptr Pointer to structure defined in SYS\TIMEB.H 
Returns No return value 


Gets the current time and stores it in the structure that timeptr points to. 
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_fullpath 


fwrite 


char * fullpath( char *buffer, const char *pathname, size_t maxlen ); 


Include STDLIB.H 

buffer Pointer to user path name buffer 

pathname Pointer to path name fragment 

maxlen Maximum length of buffer 

Returns A pointer to the absolute path in buffer if successful; NULL if not 


Expands the path name fragment pathname to form a fully qualified path that is stored in 
buffer. 
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size_t fwrite( const void *buffer, size_t size, size_t count, FILE “stream ); 


Include STDIO.H 

buffer Pointer to data to be written 

size Item size in bytes 

count Maximum number of items to be written 

stream Pointer to target stream 

Returns The number of full items actually written, which may be less than 


count if an error occurs 
Writes up to count items of length size from buffer to the output stream. 
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char *“gcvt( double value, int digits, char *buffer ); 


Include STDLIB.H 

value Value to be converted 

digits Number of significant digits stored 
buffer Storage location for result 

Returns A pointer to the string of digits 


Converts a floating-point value to a character string and stores the string in buffer. 
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short far getactivepage( void ); 


Include GRAPH.H 


Returns The number of the current active page 


Determines the current active page. 
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_getarcinfo 
Short far _getarcinfo( struct xycoord _far *start, struct xycoord _far “end, 
struct xycoord far *fillpoint ); 
Include GRAPH.H 
start Starting point of arc 
end Ending point of arc 
fillpoint Point to begin pie fill 
Returns A nonzero value if successful; 0 if not 
Finds the endpoints in viewport coordinates of the arc most recently drawn by _arc or _ pie. 
O ANS! @ DOS OOS/2 OUNIX OF XENIX 
_getbkcolor 
long far _getbkcolor( void ); 
Include GRAPH.H 
Returns The current background color value 
Determines the current background color. 
O ANS! @ DOS @ OS/2 OUNIX OF XENIX 
getc 


int getc( FILE *stream ); 


Include STDIO.H 

stream Pointer to target stream 

Returns The character read if successful; EOF to indicate an error or 
end-of-file 


Reads a single character from the current stream position and increases the associated file- 
position indicator to point to the next character. 
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getche 


 getche 


int getch( void ); 
Include CONIO.H 
Returns The character read 


Reads without echoing a single character from the console. 
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int getchar( void ); 

Include STDIO.H 

Returns The character read if successful; EOF to indicate an error or 
end-of-file 


Reads a single character from the current standard input stream, stdin, and increases the 
associated file-position indicator to point to the next character. 
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int getche( void ); 
Include CONIO.H 
Returns The character read 


Reads a single character from the console and echoes the character read. 
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_geteolor 
short far getcolor( void ); 
Include GRAPH.H 
Returns The current color index 
Determines the current color. 
O ANSI ™ DOS OOS? OUNIX OC XENIX 
_getcurrentposition 


struct xycoord far getcurrentposition( void ); 


Include GRAPH.H 


Returns The current position as an xycoord structure defined in GRAPH.H 


Gets the current graphics output position in view coordinates. 
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struct wxycoord far getcurrentposition_w( void ); 


Include GRAPH.H 


Returns The current position as a_wxycoord structure defined in GRAPH.H 


Gets the current graphics output position in window coordinates. 
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_getdcwd 


char *getcwd( char *buffer, int maxlen ); 


Include DIRECT.H, ERRNO.H 

buffer Storage location for path name 
maxlen Maximum length of path name 
Returns buffer if successful; NULL if not 
errno ENOMEM, ERANGE 


Gets the full path name (including disk drive specification) of the current working directory 
and stores it at buffer. 
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char * getdcwd( int drive, char *buffer, int maxlen ); 


Include DIRECT.H, ERRNO.H 

drive Disk drive (A: = 1, B: = 2) 
buffer Storage location for path name 
maxlen Maximum length of path name 
Returns buffer if successful; NULL if not 
errno ENOMEM, ERANGE 


Gets the full path name (including disk drive specification) of the current working directory 
on drive and stores it at buffer. 
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_getdrive 
int getdrive( void ); 
Include DIRECT.H 
Returns The integer indicating the current working drive (A: = 1, B: = 2) 
Gets the current working drive. 
O ANS! @ DOS @ OS/2 OUNIX OC XENIX 
getenv 
char *getenv( const char *varname ); 
Include STDLIB.H 
varname Name of environment variable 
Returns A pointer to the environment table entry containing the current string 
value of varname; NULL if the variable is not defined 
Searches the list of environment variables for an entry corresponding to varname. 
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_getfillmask 


unsigned char far* far getfillmask( unsigned char far “mask ); 


Include GRAPH.H 
mask Mask array 
Returns NULL if no mask is set 


Returns the current fill mask used in the floodfill, pie, ellipse, polygon, and 
_rectangle functions. 
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_getfontinfo 

short far getfontinfo( struct fontinfo far “fontbuffer ); 

Include GRAPH.H 

fontbuffer Font information 

Returns —] if a font has not been registered or loaded 

Returns the current font characteristics in a_fontinfo structure defined in GRAPH.H. 

O ANS! m@ DOS OOS/2 OUNIX CO XENIX 
_getgtextextent 

short far _getgtextextent( unsigned char far “text ); 

Include GRAPH.H 

text Text to be analyzed 

Returns The width in pixels; —1 if a font has not been registered 

Returns the width required to print the text string in the current font, using _outgtext. 

O ANS! m DOS OF OS/2 OUNIX OC XENIX 
_getgtextvector 


short xycoord far getgtextvector( void ); 


Include GRAPH.H 


Returns Vector determining the direction of font text rotation as an xycoord 
structure defined in GRAPH.H 


Finds the orientation for font text output by _setgtextvector. 
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_getimage 


_getimage_w 


void far getimage( short x/, short y/, short x2, short y2, char huge “image ); 


Include GRAPH.H ~ 
xl, yl Upper left comer of bounding rectangle 

x2, y2 Lower right corner of bounding rectangle 

image Storage buffer for screen image 

Returns No return value; check _grstatus 


Stores the screen image defined by a specified bounding rectangle into the buffer image. 


O ANS! @ DOS OO0S/2 OUNIX OO XENIX 


void far getimage_w( double wx/, double wy/, double wx2, double wy2, 
char huge “image ); 


Include GRAPH.H 

wxl, wyl Upper left corner of bounding rectangle 
wx2, wy2 Lower right corner of bounding rectangle 
image Storage buffer for screen image 

Returns No return value; check _grstatus 


Stores the screen image defined by a specified bounding rectangle into the buffer image. 
Defines the bounding rectangle with the window coordinates (wx1, wy/) and (wx2, wy2). 
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_getimage_wxy 


void far getimage_ wxy(struct wxycoord far *pwxyJ, 
struct wxycoord far *pwxy2, char huge *image ); 


Include GRAPH.H 

pwxyl Upper left corner of bounding rectangle 
pwxy2 Lower right corner of bounding rectangle 
image Storage buffer for screen image 

Returns No return value; check _grstatus 


Stores the screen image defined by a specified bounding rectangle into the buffer image. 
Defines the bounding rectangle with the window coordinate pairs pwxyl and pwxy2. 


O ANS! @ DOS OOS/ OUNIX OF XENIX 


_getlinestyle 
unsigned short far getlinestyle( void ); 
Include GRAPH.H 
Returns The default mask if no mask has been set 


Returns the current line-style mask, which is used by the _lineto, polygon, and 
_rectangle functions. 
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_getphyscoord 


getpid 


_getpixel 


struct xycoord far getphyscoord( short x, short y ); 


Include GRAPH.H 

x,y View coordinate to translate 

Returns The physical coordinates in an xycoord structure defined in 
GRAPH.H 


Translates the view coordinate (x, y) to physical coordinates, returning them in an xycoord 
structure. 


OANS| @ DOS OOS/2 OUNIX OC XENIX 


int getpid( void ); 
Include PROCESS.H 
Returns The process identification 


Gets the identification number of the calling process. 
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short far getpixel( short x, short y ); 


Include GRAPH.H 
Ky Pixel location 
Returns The color index if successful; —1 if not 


Determines the pixel value at the location specified in viewport coordinates. 
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_gettextcolor 
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_getpixel_w 


gets 


_gettextcolor 


short far getpixel_w( double wx, double wy ); 


Include GRAPH.H 
Wx, wy Pixel location 
Returns The color index if successful; —1 if not 


Determines the pixel value at the location specified in window coordinates. 


O ANS! @ DOS OF OS OUNIX OC XENIX 


char *gets( char *buffer ); 


Include STDIO.H 
buffer Storage location for input string 
Returns The argument if successful; NULL if not, or if end-of-file is reached 


Reads a line from the standard input stream, stdin, and stores it at buffer. 
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short far gettextcolor( void ); 


Include GRAPH.H 


Returns Index of the current text color 


Determines the current text attribute. 
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_gettexicursor 
short far gettextcursor( void ); 


Include GRAPH.H se 


Returns The current cursor attribute if successful; —1 if not 


Determines the current cursor shape in text modes. 
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_gettextposition 
struct recoord far _gettextposition( void ); 


Include GRAPH.H 


Returns The text position as an recoord structure defined in GRAPH.H 


Gets the current text position as an rccoord structure. 


OANS| @ DOS W@OS/2 OUNIX OC XENIX 


_gettextwindow 


void far gettextwindow( short far *r/, short far *c/, short far *r2, 
short far *c2 ); 


Include GRAPH.H 

rl Top row of current text window 

cl Leftmost column of current text window 
iz Bottom row of current text window 

c2 Rightmost column of current text window 
Returns No return value 


Gets the boundaries of the current text window. fe 
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_getvideocontig 


struct videoconfig far * far getvideoconfig( struct videoconfig far “config ); 


Include GRAPH.H 

config Configuration information 

Returns The video configuration information in a videoconfig structure de- 
fined in GRAPH.H 


Gets information about the current graphics environment as a videoconfig structure. 
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_getviewcoord 


struct xycoord far getviewcoord( short x, short y ); 


Include GRAPH.H 
x,y Physical coordinates to translate 
Returns View coordinates in an xycoord structure defined in GRAPH.H 


Translates the specified physical coordinates to view coordinates. 
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_getviewcoord_w 


struct xycoord far getviewcoord_w( double wx, double wy ); 


Include GRAPH.H 
WX, Wy Window coordinates to translate 
Returns View coordinates in an xycoord structure defined in GRAPH.H 


Translates the specified window coordinates to view coordinates. 
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_getviewcoord_wxy 


_getvisualpage 


getw 


struct xycoord far getviewcoord_wxy( struct wxycoord far *pwxy! ); 


Include GRAPH.H —~ 
pwxyl Window coordinate to translate 
Returns View coordinates in an xycoord structure defined in GRAPH.H 


Translates the specified window coordinate structure to view coordinates. 


O ANSI! M@DOS OOS/2 OUNIX' OC XENIX 


short far getvisualpage( void ); 


Include GRAPH.H 


Returns The number of the current visual page 


Gets the current visual page number. 
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int getw( FILE *stream ); 


Include STDIO.H 

stream Pointer to target stream 

Returns The integer value read if successful; EOF to indicate failure or 
end-of-file 


Reads the next binary value of type int from stream and increases the associated file 
pointer to point to the next unread character. 
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_getwindowcoord 
struct wxycoord far getwindowcoord( short x, short y ); 
Include GRAPH.H 
x,y Physical coordinates to translate 
Returns The coordinates in an _wxycoord structure defined in GRAPH.H 
Translates the view coordinates (x, y) to window coordinates and returns them in an 
_wxycoord structure. 
O ANSI! m DOS OOS/2 OUNIX OC XENIX 
_getwritemode 
short far getwritemode( void ); 
Include GRAPH.H 
Returns _GPSET, GXOR, GAND, GOR, GPRESET; —1 if an error 
occurs 
Returns the current logical write mode used by lineto, rectangle, and polygon. 
ANS] mDOS mOS2 OUNIX CXENIX 
gmtime 


struct tm *gmtime( const time_t “timer ); 


Include TIME.H 
timer Pointer to stored Greenwich mean time value 
Returns A pointer to the structure result 


Converts the timer value to a structure. 
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_grstatus 


halloc 


short far _grstatus( void ); 


Include GRAPH.H 


Returns The status of the most recently called graphics function 


Determines whether errors or warnings were generated by the most recently called graphics 
function. 


O ANS! @ DOS # OS/2 OUNIX OC XENIX 


void huge *halloc( long num, size_t size ); 


Include MALLOC.H 

num Number of elements 

size Length in bytes of each element 
Returns A pointer to the allocated space 


Allocates a huge array from the operating system consisting of num elements, each of 
which is size bytes long. 
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_hardretn 


_harderr 


_hardresume 


_hardretn 


void harderr( void( far *handler )() ); 


Include DOS.H 
handler New INT 0x24 handler 
Returns No return value 


Establishes the user-defined routine that handler points to as the handler for DOS 
INT 0x24, which is invoked when a hardware error occurs during the execution of an 


I/O request. 


O ANSI! @ DOS OOS/2 OUNIX OO XENIX 


void hardresume( int result ); 


_ Include DOS.H 


result _HARDERR IGNORE, HARDERR RETRY, 
~HARDERR_ ABORT, HARDERR FAIL 


Returns No return value 
Allows a user-defined hard I/O error handler to return to DOS. 
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void hardretn( int error ); 


Include DOS.H 
error Error to return from 
Returns No return value 


Allows a user-defined hard I/O error handler to return directly to the application program. 
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_heapadd 


_heapchk 


_heapmin 


int heapadd( void far “memblock, size_t size ); 


Include MALLOC.H = 
memblock Far pointer to heap memory _ 
size Size in bytes of memory to add 

Returns 0 if successful; —1 if not 


Adds an unused piece of memory to the heap. 


O ANSI! @ DOS WOS/2 OUNIX OC XENIX 


int heapchk( void ); 


Include MALLOC.H 
Returns _HEAPOK, HEAPEMPTY, HEAPBADBEGIN, 
~HEAPBADNODE 


Checks the heap for minimal consistency. 
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int heapmin( void ); 


Include MALLOC.H 


Returns O if successful; —1 1f not 


Releases unused memory in the heap back to the operating system. 
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_heapset 


_heapwalk 


hfree 


int heapset( unsigned int fil] ); 


Include MALLOC.H 

fill Fill character 

Returns _HEAPOK, HEAPEMPTY, HEAPBADBEGIN, 
_HEAPBADNODE 


Checks the heap for minimal consistency and then sets the heap’s free entries with the fill 
value. 


O ANS! @ DOS #8 OS/2 OUNIX' OCF XENIX 


int heapwalk( HEAPINFO “*entryinfo ); 


Include MALLOC.H 

entryinfo Structure to contain information about the next heap entry, defined in 
MALLOC.H 

Returns HEAPOK, HEAPEMPTY, HEAPBADPTR, 


~HEAPBADBEGIN, HEAPBADNODE, HEAPEND 


Walks through the heap, one entry per call, returning a pointer toa HEAPINFO structure 
that contains information about the next heap entry. 


O ANS! @ DOS @OS/2 OUNIX OC XENIX 


void hfree( void huge *memblock ); 


Include MALLOC.H 
memblock Pointer to allocated memory block 
Returns No return value 


Deallocates a huge memory block obtained with halloc and returns the freed memory to the 
operating system. 
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hypot 
double hypot( double x, double y ); 
Include MATH.H, ERRNO.H 
x,y Floating-point values 
Returns The length of the hypotenuse if successful; HUGE_VAL on overflow 
errno ERANGE 
Calculates the length of the hypotenuse of a right triangle, given the length of the two sides 
x and y. 
O ANS! m@& DOS Wf OS/2 MUNIX” @ XENIX 
hypotl 
long double hypotl( long double x, long double y ); 
Include MATH.H, ERRNO.H 
x,y Long double-precision floating-point values 
Returns The length of the hypotenuse if successful; LLHUGE_VAL on 
overflow 
errno ERANGE 


Calculates the length of the hypotenuse of a right triangle, given the length of the two sides 
x and y, using the long double-precision floating-point version of arguments and return 
values. 
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_Imagesize 


long far imagesize( short x/, short y/, short x2, short y2 ); 


Include GRAPH.H 

KL v1 Upper left corner of bounding rectangle 
x2, y2 Lower right corner of bounding rectangle 
Returns The storage size of the image in bytes 


Calculates the number of bytes needed to store the image defined by the bounding rec- 
tangle specified by the coordinates (x/, y/) and (x2, y2). 
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_imagesize_w 


long far imagesize_w( double wx/, double wy/, double wx2, double wy2 ); 


Include GRAPH.H 

wxl, wyl Upper left corner of bounding rectangle 
wx2, wy2 Lower right corner of bounding rectangle 
Returns The storage size of the image in bytes 


Calculates the number of bytes needed to store the image defined by the bounding rec- 
tangle specified by the window coordinates (wx/, wy/) and (wx2, wy2). 
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_imagesize_wxy 


inp 


long far imagesize_wxy(struct wxycoord _ far *pwxy/, 
struct wxycoord far *pwxy2 ); 


Include GRAPH.H 

pwxyl Upper left corner of bounding rectangle 
pwxy2 Lower right corner of bounding rectangle 
Returns The storage size of the image in bytes 


Calculates the number of bytes needed to store the image defined by the bounding rec- 
tangle specified by the window coordinate pairs pwxyl and pwxy2. 
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int inp( unsigned port ); 


Include CONIO.H 
port Port number 
Returns The byte read from port 


Reads a byte from the specified port. (Note: For protected-mode libraries, use a .DEF file 
containing this line: SEGMENTS _IOSEG CLASS 'IOSEG_CODE' IOPL.) 
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intdos 


intdos 


unsigned inpw( unsigned port ); 


Include CONIO.H 
port | Port number 
Returns The word read from port 


Reads a word from the specified port. (Note: For protected-mode libraries, use a .DEF file 
containing this line: SEGMENTS _IOSEG CLASS 'IOSEG_CODE' IOPL.) 
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int intdos( union REGS *inregs, union REGS *outregs ); 


Include DOS.H 

inregs Register values on call 

outre gs Register values on return 

Returns The value of the AX register after the system call is completed 


Invokes the DOS system call specified by register values defined in inregs and returns the 
effect of the system call in outregs. 
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intdosx 
int intdosx( union REGS *inregs, union REGS *outregs, struct SREGS “segregs ); 
Include DOS.H 
inregs Register values on call and return 
outre gs Register values on return 
segregs Segment-register values on call and on return 
Returns The value of the AX register after the system call is completed 
Invokes the DOS system call specified by register values defined in inregs and segregs and 
returns the effect of the system call in outregs and segregs. It accepts segment-register 
values specifying segments and pointers. 
O ANS! m DOS OOS/2 OUNIX OC XENIX 
int&6 
int int86( int intnum, union REGS “*inregs, union REGS *outregs ); 
Include DOS.H 
intnum Interrupt number 
inregs Register values on call 
outregs Register values on return 
Returns The value of the AX register after the interrupt returns 


Executes the 8086-processor-family interrupt specified by the interrupt number intnum. 
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int86x 
int int86x( int intnum, union REGS *inregs, union REGS *outregs, 
struct SREGS *segregs ); 
Include DOS.H 
inthum Interrupt number 
inregs Register values on call 
outregs Register values on return 
segregs Segment-register values on call and on return 
Returns The value of the AX register after the interrupt returns 
Executes the 8086-processor-family interrupt specified by the interrupt number intnum. It 
accepts segment-register values specifying segments and pointers. 
OANS|! @ DOS OOS/2 OUNIX OC XENIX 
isalnum 


int isalnum( int c ); 


Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; 0 if not 


Tests for alphanumeric character ('A’—’Z’, ’a’—’z’, or ’0’—’9’). 
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isalpha 


isasclil 


isatty 


int isalpha( int c ); 

Include CTYPE.H 

C Integer to be tested 

Returns A nonzero value if the integer satisfies the test condition; O if not 


Tests for letter CV A’—’Z’ or ’a’—’z’). 
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int isascii( int c ); 


Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; 0 if not 


Tests for ASCII character (0x00 — Ox7f). 
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int isatty( int handle ); 


Include 10.H 
handle Handle referring to device to be tested 
Returns A nonzero value if the device is a character device; O if not 


Determines whether handle is associated with a character device (a terminal, console, 
printer, or serial port). 
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isentr! 
int iscntrl( int c ); 
Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; 0 if not 
Tests for control character (0x00 — Ox1f or Ox7f). 
MANS! M@DOS 8 OS/2 WUNIX” Wf XENIX 
isdigit 
int isdigit( int c ); 
Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; 0 if not 
Tests for digit (0’—’9’). 
MANS! @ DOS 8 OS/2 WM UNIX” fi XENIX 
isgraph 
int isgraph( int c ); 
Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; O if not 


Tests for graphical characters (any printable character except white space). 
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islower 
int islower( int c ); 
Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; O if not 
Tests for lowercase character ('a’—’z’). 
MANS! @ DOS 8 OS/2 MUNIX’ Wf XENIX 
isprint 
int isprint( int c ); 
Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; O if not 
Tests for printable character (0x20 — Ox7e). 
MANS! @ DOS 8 OS/2 HM UNIX” Wf XENIX 
ispunct 


int ispunct( int c ); 


Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; O if not 


Tests for punctuation character. 
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isspace 
int isspace( int c ); 
Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; O if not 
Tests for white space character (0x09 — OxOd or 0x20). 
MANS! @DOS #8 OS/2 MUNIX Wf XENIX 
isupper 
int isupper( int c ); 
Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; O if not 
Tests for uppercase character (A’—’Z’). 
MANS! @ DOS 8 OS/2 MUNIX Wf XENIX 
isxdigit 


int isxdigit( int c ); 


Include CTYPE.H 
C Integer to be tested 
Returns A nonzero value if the integer satisfies the test condition; 0 if not 


Tests for hexadecimal digit ( A’—’F’,’a’—’f’, or ’0’—-9’). 
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char *itoa( int value, char “string, int radix ); 


Include STDLIB.H 

value Number to be converted 
string String result 

radix Base of value 

Returns A pointer to string 


Converts the digits of the given value to a null-terminated character string and stores the 
result (up to 17 bytes) in string. 
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double jn( int n, double x ); 


Include MATH.H 

n Integer order 

x Floating-point value 

Returns The result of a Bessel function of x 


Returns the Bessel function of the first kind (order n). 
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long double _jni( int n, long double x ); 


Include MATH.H 

n Integer order 

8 Long double-precision floating-point value 
Returns The result of a Bessel function of x 


Returns the Bessel function of the first kind (order n). Long double-precision floating-point 
version of jn. 
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double j1( double x ); 

Include MATH.H 

x Floating-point value 

Returns The result of a Bessel function of x 


Returns the Bessel function of the first kind (order 1). 
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long double _jil( long double x ); 


Include MATH.H 
6 Long double-precision floating-point value 
Returns The result of a Bessel function of x 


Returns the Bessel function of the first kind (order 1). Long double-precision floating-point 
version of jl. 
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double j0( double x ); 

Include MATH.H a 
x Floating-point value 

Returns The result of a Bessel function of x 


Returns the Bessel function of the first kind (order 0). 
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long double _j0I( long double x ); 


Include MATH.H 
x Long double-precision floating-point value 
Returns The result of a Bessel function of x 


Returns the Bessel function of the first kind (order 0). Long double-precision floating-point 
version of j0. 
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int kbhit( void ); 
Include CONIO.H 
Returns A nonzero value if a key has been pressed; 0 if not 


Checks the console for an unread keystroke. 
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Idexp 


long labs( long 7 ); 

Include STDLIB.H or MATH.H 
n Long integer value 
Returns The absolute value of n 


Calculates the long-integer absolute value of n. 
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double Idexp( double x, int exp ); 


Include MATH.H, ERRNO.H 

x Floating-point value 

exp Integer exponent 

Returns The value of x * 2°” if successful; + HUGE_VAL (depending on the 
sign of x) on overflow 

errno ERANGE 


Converts the mantissa and exponent to a floating-point value. 
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long double Idexpl( long double x, int exp ); 


Include MATH.H, ERRNO.H 

x Long double-precision floating-point value 

exp Integer exponent 

Returns The value of x * 2°? if successful; + LHUGE_VAL (depending on 
the sign of x) on overflow 

errno ERANGE 


Converts the mantissa and exponent to a floating-point value. Long double-precision 
floating-point version of Idexp. 
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Idiv_t Idiv( long int numer, long int denom ); 


Include STDLIB.H 

numer Numerator 

denom Denominator 

Returns The quotient and remainder as an Idiv_t structure 


Computes the quotient and remainder for a pair of long integer values. 
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lfind 
void *Ifind( const void *key, const void *base, unsigned int *num, unsigned int width, 
int( “compare )( const void *elem1, const void *elem2 ) ); 
Include SEARCH.H 
key Object to search for 
base Pointer to base of search data 
num Number of elements 
width Element width 
compare Pointer to comparison function 
eleml Pointer to the key for the search 
elem2 Pointer to the array element to be compared with the key 
Returns A pointer to an array element corresponding to key if successful; 
NULL if not 
Performs a linear search for the value key in an array of num elements, each of width bytes 
in size. 
OANS| @ DOS #8 OS/2 M UNIX” @ XENIX 
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short far _lineto( short x, short y ); 


Include GRAPH.H 
x,y End point 
Returns A nonzero value if successful; 0 1f not 


Draws a line from the current position up to and including the view coordinate (x, y). 
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_lineto_w 

short far lineto_w( double wx, double wy ); 

Include GRAPH.H 

WX, Wy End point 

Returns A nonzero value if successful; 0 if not 

Draws a line from the current position up to and including the window coordinate 

(wx, wy). 

O ANS! @ DOS OOS/2 OUNIX OC XENIX 
localeconv 

struct Iconv “localeconv( void ); 

Include LOCALE.H 

Returns A pointer to a structure of type Iconv 

Gets detailed information on locale settings. 

MANS! @ DOS 8 OS/2 OUNIX OC XENIX 
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struct tm *localtime( const time_t *timer ); 


Include TIME.H 
timer Pointer to stored time structure 
Returns Pointer to a structure resolved; NULL if time cannot be interpreted 


Converts a time stored as a long value to a structure of type tm. 
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locking 
int locking( int handle, int mode, long nbytes ); 
Include SYS\LOCKING.H, IO.H, ERRNO.H 
handle File handle 
mode LK_ LOCK, LK_RLCK, LK_NBLCK, LK_NBRLCK, LK_UNLCK 
nbytes Number of bytes to lock 
Returns 0 if successful; —1 1f not 
errno EACCESS, EBADF, EDEADLOCK, EINVAL 
Locks or unlocks nbytes bytes of the file specified by handle. 
O ANS! @ DOS #8 OS/2 MUNIX” @ XENIX 
log 
double log( double x ); 
Include MATH.H, ERRNO.H 
i Floating-point value 
Returns The natural logarithm of x 
errno EDOM, ERANGE 


Calculates the natural logarithm of x. 
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logl 
long double logl( long double x ); 
Include MATH.H, ERRNO.H 
x Long double-precision floating-point value 
Returns The natural logarithm of x 
errno EDOM, ERANGE 
Calculates the natural logarithm of x. Long double-precision floating-point version of log. 
OANS! @ DOS ™OS/2 OUNIX' OC XENIX 
log10 
double log10( double x ); 
Include MATH.H, ERRNO.H 
x Floating-point value 
Returns The base-10 logarithm of x 
errno EDOM, ERANGE 


Calculates the base-10 logarithm of x. 
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longjmp 


long double log101( long double x ); 


Include MATH.H, ERRNO.H 

x Long double-precision floating-point value 
Returns The base-10 logarithm of x 

errno EDOM, ERANGE 


Calculates the base-10 logarithm of x. Long double-precision floating-point version of 
log10. 
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void longjmp( jmp_ buf ezv, int value ); 


Include SETJMP.H 

env Variable in which environment is stored 
value Value to be returned to setjmp call 
Returns No return value 


Restores a stack environment and execution locale previously saved in env by setjmp. 
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unsigned long _Irotl( unsigned long value, int shift ); 


Include STDLIB.H 

value Value to be rotated 
shift Number of bits to shift 
Returns The rotated value 


Rotates the value to the left by shift bits. 
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unsigned long _Irotr( unsigned long value, int shift ); 


Include STDLIB.H 

value Value to be rotated 
shift Number of bits to shift 
Returns The rotated value 


Rotates the value to the right by shift bits. 
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lsearch 


lseek 


void *Isearch( const void *key, const void *base, unsigned int “num, unsigned int width, 
int( “compare )( const void *elem/, const void *elem2 ) ); 


Include SEARCH.H 

key Object to search for 

base Pointer to base of search data 

num Number of elements 

width Element width 

compare Pointer to comparison function 

elem! Pointer to the key for the search 

elem2 Pointer to the array element to be compared with the key 

Returns A pointer to the array element base that matches Key if the key is 
found; a pointer to the newly added item at the end of the array 
otherwise 


Performs a linear search for the value key in an array of num elements, each of width bytes 
in size. If the value is not found, it adds key to the end of the list. 
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long Iseek( int handle, long offset, int origin ); 


Include IO.H, STDIO.H, ERRNO.H 

handle Handle referring to open file 

offset Number of bytes from origin 

origin SEEK_ SET, SEEK CUR, SEEK_END 

Returns The offset in bytes of the new position if successful; —1L if not 
errno EBADF, EINVAL 


Moves the file pointer associated with handle to a new location that is offset bytes from 
origin. | 
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char *Itoa( long value, char *string, int radix ); 


Include STDLIB.H 

value Number to be converted 
string String result 

radix Base of value 

Returns A pointer to string 


Converts the digits of value to a null-terminated character string and stores the result (up to 
33 bytes) in string. 
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void makepath( char *path, char *drive, char *dir, char “fname, char *ext ); 


Include STDLIB.H 

path Full path-name buffer 
drive Drive letter 

dir Directory path 

fname File name 

ext File extension 
Returns No return value 


Creates a single path name, composed of a drive letter, directory path, file name, and 
file-name extension. 
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malloc 
void *malloc( size_t size ); 
Include STDLIB.H or MALLOC.H 
size Number of bytes to allocate 
Returns A pointer to the allocated space 
Allocates a memory block of at least size bytes. 
MANS! @ DOS 8 OS/2 MB UNIX” Wf XENIX 
matherr 
int matherr( struct exception “except ); 
Include MATH.H 
except Math exception information 
Returns A nonzero value if successful; 0 if not 
Processes errors generated by the functions of the math library. The user can provide a 
different matherr definition for special treatment of math errors. 
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int matherrl(struct exceptionl *except ); 


Include MATH.H 
except Math exception information 
Returns A nonzero value if successful; 0 if not 


Processes errors generated by the long double-precision functions of the math library. 
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max 

type max( type a, type b ); 

Include STDLIB.H 

type Any numerical data type 

a,b Values to compare 

Returns The larger of the two arguments 

Compares two values of the same data type, returning the larger one. 

O ANS! @ DOS WOS/2 OUNIX OC XENIX 
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size_t _memavl( void ); 
Include MALLOC.H 


Returns The size in bytes as an unsigned integer 


Returns the approximate amount of memory available for dynamic memory allocation in 
the near heap (default data segment). 
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memchr 
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memecpy 


memehr 


void “memccpy( void *dest, void *src, int c, unsigned int count ); 


Include STRING.H or MEMORY.H 

dest ‘Pointer to destination 

STC Pointer to source 

C Last character to copy 

count Number of characters 

Returns A pointer to the byte in dest that immediately follows the copied 
character (c) if successful; NULL if count bytes copied before c 
was found 


Copies zero or more bytes of the source to the destination, up to and including the first oc- 
currence of the character c or until count bytes have been copied, whichever comes first. 
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void *“memchr( const void *buf, int c, size_t count ); 


Include STRING.H or MEMORY.H 

buf Pointer to buffer 

C Character to search for 

count Maximum number of characters to scan 

Returns A pointer to the first location of c in buf if successful; NULL if not 


Looks for the first occurrence of a character in the first count bytes of the buffer. 
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mememp 


memepy 


int memcmp( const void *bufl, const void *buf2, size_t count ); 


Include STRING.H or MEMORY.H 

buf1, buf2 Pointers to buffers to compare 

count Maximum number of characters to compare 

Returns A value less than, equal to, or greater than 0 if the size of the buffer 


pointed to by buf is less than, equal to, or greater than the size of 
the buffer pointed to by buf2. 


Compares the first count bytes of two buffers and returns a value indicating their 
relationship. 
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void “memcpy( void *dest, const void *src, size_t count ); 


Include STRING.H or MEMORY.H 

dest Pointer to destination buffer 

STC Pointer to the buffer to copy from 
count Number of characters to copy 
Returns dest 


Copies count bytes of src to dest. The first count bytes of src and dest should not overlap. 
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memicmp 
int memicmp( void *buf], void *buf2, unsigned int count ); 
Include STRING.H or MEMORY.H 
bufl, buf2 Pointers to buffers to compare 
count Number of characters 
Returns A value less than, equal to, or greater than O if the size of the buffer 
pointed to by buf/ is less than, equal to, or greater than the size of 
the buffer pointed to by buf2. 
Compares the first count bytes of buf! and buf2 byte-by-byte, without regarding case (all 
letters are considered lowercase), and returns a value indicating their relationship. 
O ANS! @ DOS #8 OS/2 OUNIX OC XENIX 
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size t_memmax( void ); 


Include MALLOC.H 


Returns The size of the largest contiguous block of memory that can be allo- 
cated from the near heap if successful; 0 if nothing more can be 
allocated from the near heap 

Determines the size of the largest contiguous free memory block in the near heap. 
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memset 


void *memmove( void “dest, const void *src, size_t count ); 


Include STRING.H 

dest Pointer to destination buffer 
STC Pointer to source buffer 
count Number of characters to copy 
Returns The value of dest 


Copies count characters from src to dest and handles overlap properly. 
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void *memset( void *dest, int c, size_t count ); 


Include STRING.H or MEMORY.H 
dest Pointer to destination buffer 

C Character to set to 

count Number of characters to be set 
Returns A pointer to dest 


Sets the first count bytes of dest to the character c. 
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min 

type min( type a, type b ); 

Include STDLIB.H 

type Any numeric data type 

a,b Values to compare 

Returns The smaller of the two arguments 

Compares two values of the same data type and returns the smaller of them. 

O ANS! @ DOS #OS/2) OUNIX OC XENIX 
mkdir 

int mkdir( char *dirname ); 

Include DIRECT.H, ERRNO.H 

dirname Path name for new directory 

Returns 0 if successful; —1 if not 

errno EACCESS, ENOENT 

Creates a new directory with the specified directory name. 

O ANS! @ DOS #8 OS/2 OUNIX OC XENIX 
mktemp 


char *mktemp( char “template ); 


Include 1O.H 
template File-name pattern 
Returns A pointer to the modified template if successful; NULL if not 


Creates a unique file name by modifying the given file-name pattern. 
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mktime 


modf 


time_t mktime( struct tm *timeptr ); 


Include TIME.H 
timeptr Local time structure 
Returns The calendar time encoded as a type time_t value if successful; 


—1 cast as type time_t if not 
Converts the local time to a calendar value. 
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double modf( double x, double *inztptr ); 


Include MATH.H 

x Floating-point value 

intptr Pointer to stored integer portion 
Returns The signed fractional portion of x 


Breaks down the floating-point value x into fractional and integer parts with the same sign 
as X. 
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movedata 


long double modfl( long double x, long double *intptr ); 


Include MATH.H 

x Long double-precision floating-point value 
intptr Pointer to stored integer portion 

Returns The signed fractional portion of x 


Breaks down the long double-precision floating-point value of x into fractional and integer 
parts with the same sign as x. 
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void movedata( unsigned int srcseg, unsigned int srcoff, unsigned int destseg, 
unsigned int destoff, unsigned int count ); 


Include STRING.H or MEMORY.H 
STCSE Segment address of source 
srcoff Segment offset of source 
destseg Segment address of destination 
destoff Segment offset of destination 
count Number of bytes 

Returns No return value 


Copies count bytes from the source address specified by srcseg:srcoff to the destination 
address specified by destseg:destoff. 
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_moveto 


_moveto_w 


_msize 


struct xycoord far moveto( short x, short y ); 


Include GRAPH.H 
x,y Target position 
Returns The coordinates of the previous position in an xycoord structure 


Moves the current graphics-output position to the specified view coordinates. 
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struct wxycoord far moveto_w( double wx, double wy ); 


Include. GRAPH.H 
Wx, Wy Target position 
Returns The coordinates of the previous position in a_wxycoord structure 


Moves the current graphics-output position to the specified window coordinates. 
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size_t _msize( void *memblock ); 


Include MALLOC.H 
memblock Pointer to memory block 
Returns The size in bytes 


An unsigned integer representing the size in bytes of the memory block allocated by a call 
to calloc, malloc, or realloc. 
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277 _nexpand 
_ncalloc 
void near * ncalloc( size_t num, size_t size ); 
Include MALLOC.H 
num Number of elements 
size Length in bytes of each element 
Returns A near pointer to the allocated space if successful; NULL if there is 
insufficient memory available 
Allocates storage for an array of num elements, each of length size bytes in the near heap. 
Storage is initialized to zero. 
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void near * nexpand( void near “memblock, size_t size ); 


Include MALLOC.H 

memblock Pointer to previously allocated memory block 

size New size in bytes 

Returns A near pointer to the resized block if successful; NULL if there is in- 
sufficient memory 


Changes the size of a previously allocated memory block by attempting to expand or con- 
tract the block without moving its location in the near heap. 
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void nfree( void near *memblock ); 


Include MALLOC.H 
memblock Allocated memory block in the near heap 
Returns No return value 


Frees a memory block in the near heap. 
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int nheapchk( void ); 


Include MALLOC.H 
Returns _HEAPOK, HEAPEMPTY, HEAPBADBEGIN, 
_HEAPBADNODE 


Checks for minimal consistency on the dynamically allocated memory space in the default 
data segment, or “near heap.” The consistency check determines whether all the near heap 
entries are within the bounds of the heap’s current memory allocation. 
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int nheapmin( void ); 


Include MALLOC.H 


Returns 0 if successful; —1 1f not 


Releases unused memory in the near heap back to the operating system. 
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_hnheapset 


_hheapwalk 


_nmalloe 


int nheapset( unsigned int fil ); 


Include MALLOC.H 

fill Fill character 

Returns _HEAPOK, HEAPEMPTY, HEAPBADBEGIN, 
~HEAPBADNODE 


Checks for minimal consistency in the near heap and then sets the heap’s free entries with 
the fill value. 
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int nheapwalk( HEAPINFO *enztryinfo ); 


Include MALLOC.H 

entryinfo Structure to contain information about the next near heap entry de- 
fined in MALLOC.H 

Returns _HEAPOK, HEAPEMPTY, HEAPBADPTR, 


"HEAPBADBEGIN, HEAPBADNODE, HEAPEND 


Walks through the near heap, one entry per call, returning a pointer to a_ HEAPINFO 
structure that contains information about the next near heap entry. 
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void near * nmalloc( size_t size ); 


Include MALLOC.H 
size Number of bytes to allocate 
Returns A near pointer to the allocated space if successful; NULL if not 


Allocates a memory block of at least size bytes in the near heap. 
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_nmsize 
size t_nmsize( void near *memblock ); 
Include MALLOC.H 
memblock Pointer to near memory block 
Returns The size in bytes 
An unsigned integer representing the size in bytes of the near-heap memory block allocated 
by acall to _nealloc, nmalloc, or _nrealloc 
OANS| m DOS wm OS/2 OUNIX OC XENIX 
_nrealloc 
void near * nrealloc( void _near *memblock, size_t size ); 
Include MALLOC.H 
memblock Pointer to previously allocated memory block 
size New size in bytes 
Returns A near pointer to the reallocated memory block if successful; NULL | 
if not 
Changes the size and possibly the location of a memory block in the near heap. 
O ANS! mw DOS mm OS/2 OUNIX O XENIX 
_nstrdup 


char_near* far _nstrdup( const char _far “string ); 


Include STRING.H 
string Source string 
Returns A near pointer to the storage space containing the duplicate string 


Duplicates string, copying it to memory allocated by _nmalloc. Model-independent form 
of strdup. 
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onexit 
onexit_t onexit( onexit_t func ); 
Include. STDLIB.H 
func Function to call on exit 
Returns A pointer to the function if successful; NULL if there is no space left 
to store the function pointer 
Creates a register of functions to be called (last-in, first-out) when the program terminates 
normally. 
O ANS! @ DOS #8 OS/2 WM UNIX” @ XENIX 
open 


int open( char “filename, int oflag [, int pmode] ); 


Include SYS\TYPES.H, SYS\STAT-H, IO.H, ERRNO.H, FCNTL.H 

filename File path name 

oflag O_APPEND, O_BINARY, O_ CREAT, O_ EXCL, O RDONLY, 
O_RDWR, O_TEXT, O_TRUNC, O WRONLY 

pmode S_IWRITE, S TREAD, S TREAD |S IWRITE 

Returns A handle for the opened file if successful; —1 if not 

errno EACCESS, EEXIST, EINVAL, EMFILE, ENOENT 


Opens the file specified by filename and prepares the file for subsequent reading or writing, 
as defined by oflag and, optionally, pmode. 
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_ outgtext 


_outmem 


outp 


void far outgtext( unsigned char far “text ); 


Include GRAPH.H 
text Text to be output 
Return No return value 


Outputs the null-terminated string text using the current font and rotation on the screen at 
the current graphics-output position. 
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void far outmem( unsigned char _far *zext, short length ); 


Include GRAPH.H 

text Text to be output 

length Number of characters to be output 
Returns No return value 


Outputs the specified number of characters from a buffer. 


O ANS! W@ DOS W@OS/2 OUNIX OC XENIX 


int outp( unsigned port, int databyte ); 


Include CONIO.H 

port Port number 
databyte Output value 
Returns The output data 


Writes a byte to the specified output port. (Note: For protected-mode libraries, use a .DEF 
file containing this line: SEGMENTS _IOSEG CLASS, 'TOSEG_CODE' IOPL.) 
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outpw 
unsigned outpw( unsigned port, unsigned dataword ); 
Include CONIO.H 
port Port number 
dataword Output value 
Returns The output data 
Writes a word to the specified output port. (Note: For protected-mode libraries, use a .DEF 
file containing this line: SEGMENTS _JOSEG CLASS 'IOSEG_CODE' IOPL.) 
O ANS! @ DOS #8 OS/2 OUNIX OC XENIX 
_outtext 
void far outtext( unsigned char far “text ); 
Include GRAPH.H 
text Text to be output 
Return No return value 
Outputs the null-terminated string, text, at the current text position using the current text 
color. 
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int pclose( FILE “stream ); 


Include STDIO.H 
stream Return value from previous call to popen 
Returns The exit status of the child command if successful; -1 if not 


Closes stream and waits for the associated child command. 
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perror 


void perror( const char *string ); 


Include STDIO.H 
string User-supplied message 
Returns No return value 


Prints an error message to stderr. The string argument is printed first, followed by a colon, 
then by the system error message for the last library call that produced the error, and finally 
by a newline character. 
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short far pg analyzechart(chartenv far *env, char far * _far *categories, 
float far *values, short n ); 


Include PGCHART.H 

env Chart environment variable 
categories Array of category variables 

values Array of data values 

n Number of data values to chart 
Returns 0 if successful; a nonzero value if not 


Analyzes a single series of data and fills the chart environment with default values for a 
single-series bar, column, or line chart, depending on the type specified in the function call. 
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_pg_analyzechartms 


short far pg analyzechartms( chartenv far *enyv, char far * far *categories, 
float far *values, short nseries, short n, short arraydim, 
char far * far “serieslabels ); 


Include PGCHART.H 

env Chart environment variable 
categories Array of category variables 

values Array of data values 

nseries Number of series to chart 

n Number of data values to chart 
arraydim Row dimension of data array 
serieslabels Array of labels for series 

Returns O if successful; a nonzero value if not 


Analyzes a multiple series of data and fills the chart environment with default values for 
a multiseries bar, column, or line chart, depending on which type is specified in the 
function call. 
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_pg_analyzepie 


short far pg analyzepie( chartenv far *env, char far * far “categories, 
float far *values, short far *explode, short n ); 


Include 
envy 
categories 
values 
explode 

n 


Returns 


PGCHART.H 

Chart environment structure 
Array of category labels 

Array of data values 

Array of explode flags 
Number of data values to chart 


0 if successful; a nonzero value if not 


Analyzes a single series of data and fills the chart environment for a pie chart using the data 
contained in the array values. 


O ANS! 
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short far pg analyzescatter( chartenv _far *env, float far “xvalues, 
float far *yvalues, short n ); 


Include 
env 
xvalues 
yvalues 
n 


Returns 


PGCHART.H 

Chart environment structure 
Array of x-axis data values 
Array of y-axis data values 
Number of data values to chart 


0 if successful; a nonzero value if not 


Analyzes a single series of data and fills the chart environment for a single-series scatter 


diagram. 
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_pg_chart 
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_pg_analyzescatterms 


_pg_chart 


short far pg analyzescatterms(chartenv far “env, float far *“xvalues, 
float far *yvalues, short nseries, short n, short rowdim, 
char far * far *serieslabels ); 


Include PGCHART.H 

env Chart environment structure 

xvalues Array of x-axis data values 

yvalues Array of y-axis data values 

nseries Number of series to chart 

n Number of data values to chart 
rowdim Row dimension of data array 
serieslabels Array of labels for series 

Returns O if successful; a nonzero value if not 


Analyzes a multiple series of data and fills the chart environment for a multiseries scatter 
diagram. 
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short far pg chart(chartenv far *env, char far * far “categories, 
float far *values, short n ); 


Include PGCHART.H 

env Chart environment variable 
categories _ Array of category variables 

values Array of data values 

n Number of data values to chart 
Returns O if successful; a nonzero value if not 


Displays a single-series bar, column, or line chart, depending on the type specified in the 
chart environment variable. 
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_pg_chartms 


short far pg chartms( chartenv far *env, char far * far *categories, 
float far “values, short nseries, short n, short arraydim, 
char far * far *serieslabels ); 


Include PGCHART.H 

env Chart environment variable 
categories Array of category variables 

values Array of data values 

nseries Number of series to chart 

n Number of data values to chart 
arraydim Row dimension of data array 
serieslabels Array of labels for series 

Returns 0 if successful; a nonzero value if not 


Displays a multiseries bar, column, or line chart, depending on the type specified in the 
chart environment. 
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_pg_chartpie 


short far pg chartpie(chartenv far *env, char far * far “categories, 
float far *values, short far *explode, short n ); 


Include PGCHART.H 

env Chart environment structure 
categories Array of category labels 

values Array of data values 

explode Array of explode flags 

n Number of data values to chart 
Returns 0 if successful; a nonzero value if not 


Displays a pie chart for the data contained in the array values. Pie charts are formed from a 
single series of data (there is no multiseries version of pie charts as there is for other chart 


types). 
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_pg_chartscatter 


short far pg chartscatter( chartenv far “env, float far *xvalues, 
float far *yvalues, short n ); 


Include PGCHART.H 

env Chart environment structure 

xvalues Array of x-axis data values 

yvalues Array of y-axis data values 

n Number of data values to chart 
Returns 0 if successful; a nonzero value if not 


Displays a scatter diagram for a single series of data. 
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_pg_chartscatterms 


short far pg chartscatterms( chartenv far *env, float far *xvalues, 
float far *yvalues, short nseries, short n, short rowdim, 
char far * far *serieslabels ); 


Include PGCHART.H 

env Chart environment structure 

xvalues Array of x-axis data values 

yvalues Array of y-axis data values 

nseries Number of series to chart 

n Number of data values to chart 
rowdim Row dimension of data array 
serieslabels Array of labels for series 

Returns 0 if successful; a nonzero value if not 


Displays a scatter diagram for more than one series of data. 
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short far pg defaultchart( chartenv far *env, short charttype, short chartstyle ); 


Include PGCHART.H 

env Chart environment structure 

charttype _PG_BARCHART, PG COLUMNCHART, PG LINECHART, 
_PG_SCATTERCHART, PG PIECHART 

chartstyle Chart style 1 or 2 

Returns 0 if successful; a nonzero value if not 


Initializes all necessary variables in the chart environment for the chart type by the variable 
charttype. 
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_pg_geitchardef 


short far pg getchardef( short charnum, unsigned char _far *chardef ); 


Include PGCHART.H 

charnum ASCII number of character 

chardef Pointer to 8-by-8 bit map array 
Returns O if successful; a nonzero value if not 


Retrieves the current 8-by-8 pixel bit map for the character with the ASCII number 
charnum. The bit map is stored in the chardef array. 
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_pg_getpalette 


short far pg getpalette( paletteentry far *palette ); 


Include PGCHART.H 
palette Pointer to first palette structure in array 
Returns 0 if successful; BADSCREENMODE if current palettes have not 


been initialized by a previous call to _pg_setpalette 
Retrieves palette colors, line styles, fill patterns, and plot characters for all palettes. The 
pointer palette points to an array of palette structures that will contain the desired palette 


values. 
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_pg_getstyleset 


void far pg getstyleset( unsigned short far *styleset ); 


Include PGCHART.H 
styleset Pointer to current styleset 
Return No return value 


Retrieves the contents of the current styleset. 
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_pg_hlabelchart 


_pg_initchart 


short far pg hlabelchart( chartenv far *env, short x, short y, short color, 
char far */abel ); 


Include PGCHART.H 

env Chart environment structure 

x Pixel x-coordinate for text 

y Pixel y-coordinate for text 

color Color code for text 

label Label text 

Returns 0 if successful; a nonzero value if not 


Writes text horizontally on the screen. The arguments x and y are pixel coordinates for the 
beginning location of text relative to the upper left corner of the chart window. 
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short far pg initchart( void ); 


Include PGCHART.H 


Returns 0 if successful; a nonzero value if not 


Initializes the presentation graphics package. It initializes the color and style pools, resets 
the chartline styleset, builds default palette modes, and reads the presentation graphics char- 
acter font definition from the disk. This function is required in all programs that use presen- 
tation graphics. 
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_pg_resetpalette 
short far pg_resetpalette( void ); 


Include PGCHART.H 
Returns 0 if successful; BADSCREENMODE if the screen mode is not valid 


Sets the palette colors, line styles, fill patterns, and plot characters for the palette to the de- 
fault for the current screen mode. 
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_pg_resetstyleset 
void far pg_resetstyleset( void ); 


Include PGCHART.H 


Returns No return value 
Reinitializes the styleset to the default values for the current screen mode. 
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_pg_setchardef 


short far pg _setchardef( short charnum, unsigned char _far “chardef ); 


Include PGCHART.H 

charnum ASCII number of character 
chardef Pointer to 8-by-8 bit map array 
Returns No return value 


Sets the 8-by-8 pixel bit map for the character with the ASCII number charnum. The bit 
map is stored in the chardef array. 
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_pg_setpalette 


short far pg setpalette( paletteentry far *palette ); 


Include PGCHART.H 
palette Pointer to first palette structure in array 
Returns 0 if successful; BADSCREENMODE if the new palettes are not valid 


Sets palette colors, line styles, fill patterns, and plot characters for all palettes. The pointer 
palette points to an array of palette structures that contains the desired palette values. 
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_pg_setstyleset 


void far pg setstyleset( unsigned short far *styleset ); 


Include PGCHART:.H 
styleset Pointer to new styleset 
Returns No return value 


Sets the current styleset. 
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_pie 


short far pg viabelchart( chartenv _far *env, short x, short y, short color, 
char far */abel ); 


Include PGCHART.H 
env Chart environment structure 
me Pixel x-coordinate for text 
y Pixel y-coordinate for text 
color Color code for text 
label Label text 
Returns O if successful; a nonzero value if not 


Writes text vertically on the screen. The arguments x and y are pixel coordinates for the 
beginning location of text relative to the upper left corner of the chart window. 
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short far _pie( short control, short x/, short y/, short x2, short y2, short x3, short y3, 
short x4, short y4 ); 


Include GRAPH.H 

control _GBORDER, GFILLINTERIOR 

xl, yl Upper left corner of bounding rectangle 

0 ie Lower right corner of bounding rectangle 
x3, y3 Start vector 

x4, y4 End vector 

Returns A nonzero value if successful; O if not 


Draws a pie-shaped wedge by drawing an elliptical arc whose center and two endpoints are 
joined by lines. Points are defined using the view coordinate system. 
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short far _pie_w( short control, double x/, double y/, double x2, double y2, 
double x3, double y3, double x4, double y4 ); 


Include GRAPH.H 

control Fill-control constant 

xl, yl Upper left corner of bounding rectangle 
X22 Lower right corner of bounding rectangle 
363 Start vector 

x4, y4 End vector 

Returns A nonzero value if successful; O if not 


Draws a pie-shaped wedge by drawing an elliptical arc whose center and two endpoints are 
joined by lines. Points are defined using the window coordinate system. 
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short far _pie_wxy( short control, struct wxycoord far “pwxy1, 
struct wxycoord far *pwxy2, struct wxycoord far *pwxy3, 
struct wxycoord far *pwxy4 ); 


Include GRAPH.H 

control _GBORDER, GFILLINTERIOR 

pwxyl Upper left corner of bounding rectangle 
pwxy2 Lower right corner of bounding rectangle 
Pwxy3 Start vector 

pwxy4 End vector 

Returns A nonzero value if successful; O if not 


Draws a pie-shaped wedge by drawing an elliptical arc whose center and two endpoints are 
joined by lines. Points are defined using the window coordinate system. 
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_polygon 


int pipe( int “phandles, unsigned int psize, int textmode ); 
_PIp 


Include IO.H, FCONTL.H, ERRNO.H 

phandles Pointer to read and write handles (phandles[0] and phandles{1], 
respectively) 

psize Amount of memory, in bytes, reserved for the pipe 

textmode O BINARY, O TEXT 

Returns 0 if successful; —1 if not 

errno EMFILE, ENFILE 


Creates a pipe for both reading and writing, generally in preparation for linking it to a child 
process. 
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short far polygon( short control, struct xycoord _far “points, short numpoints ); 


Include GRAPH.H 

control _GFILLINTERIOR, GBORDER 

points Array of xycoord structures specifying the polygon’s vertices 
numpoints Number of vertices 

Returns A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws or scan-fills a polygon, using the view coordinate system. 
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_polygon_w 
short far polygon_w( short control, double far *points, short numpoints ); 
Include GRAPH.H 
control _GFILLINTERIOR, GBORDER 
points Values specifying the polygon’s vertices 
numpoints Number of vertices 
Returns A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws or scan-fills a polygon, using the window coordinate system. 
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_polygon_wxy 


Short far polygon_wxy( short control, struct wxycoord far *points, 
short numpoints ); 


Include GRAPH.H 

control _GFILLINTERIOR, GBORDER 

points Array of _wxycoord structures specifying the polygon’s vertices 
numpoints Number of vertices 

Returns A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws or scan-fills a polygon, using the window coordinate system. 
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pow 


FILE * _popen( char “command, char *mode )3 


Include STDIO.H 

command Command string 

mode Access permissions: "r", "rt", "rb", "w", "wt", "wb" 

Returns : stream associated with one end of the pipe if successful; NULL 
uw not 


Creates a pipe and asynchronously executes a child copy of the command processor. 
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double pow( double x, double y ); 


Include MATH.H, ERRNO.H 

x Number to be raised 

y Power of x 

Returns The value of x”; 1 if x is not O and y is 0; + HUGE_VAL if x is 0 and 
y is negative; 0 if both x and y are O or if x is negative and y is not an 
integer 

errno EDOM, ERANGE 


Computes the value of x’. 
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long double powl( long double x, long double y ); 


Include 


Xx 


x 


Returns 


errno 


MATH.H, ERRNO.H 
Number to be raised 
Power of x 


The value of x”; 1 if x is not 0 and y is 0; + LHUGE_ VAL if x is 0 
and y is negative; 0 if both x and y are O or if x is negative and y is 
not an integer 


EDOM, ERANGE 


Computes the value of x”. Long double-precision floating-point version of pow. 


O ANSI 
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int printf( const char *format [, argument |... ); 


Include 
format 


argument 


Returns 


STDIO.H 
Format-control string 


Optional arguments, variables of the type specified in the format- 
control string 


The number of characters printed if successful; a negative value if not 


Formats and prints a series of characters and values to the standard output stream, stdout. 
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pute 
int putc( int c, FILE *stream ); 
~ Include STDIO.H 
C Character to be written 
stream Pointer to target stream 
Returns The character written if successful; EOF may indicate failure 
Writes the single character c to the output stream at the current position. 
MANS! @DOS #8 OS/2 MUNIX” Mi XENIX 
putch 
int putch( int c ); 
Include CONIO.H 
C Character to be output 
Returns c if successful; EOF if not 
Writes the character c directly to the console. 
O ANS! m@ DOS #@ OS/2 DO UNIX CO XENIX 
putchar 


int putchar( int c ); 


Include STDIO.H 
6 Character to be written 
Returns The character written if successful; EOF may indicate failure 


Writes the single character c to the standard output stream, stdout. 
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int putenv( char *envstring ); 


Include STDLIB.H 
envstring Environment-string definition 
Returns 0 if successful; —1 if not 


Adds or removes an environment variable or modifies the value of an existing one. 
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void far putimage( short x, short y, char huge *image, short action ); 


Include GRAPH.H 

x,y Position of upper left corner of image 

image Stored image buffer 

action _GAND, GOR, GPRESET, GPSET, GXOR 
Returns No return value; check _grstatus 


Transfers to the screen the image stored in the buffer image, placing the upper left corner of 
the image at the view coordinate (x, y). 
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_putimage_w 
void far putimage_w( double wx, double wy, char huge “image, short action ); 
Include GRAPH.H 
wx, wy Position of upper left corner of image 
image Stored image buffer 
action _GAND, GOR, GPRESET, GPSET, GXOR 
Returns No return value; check _grstatus 
Transfers to the screen the image stored in the buffer image, placing the upper left corner of 
the image at the window coordinate (wx, wy). 
O ANSI! m DOS OOS/2 OUNIX CO XENIX 
puts 


int puts( const char “string ); 


Include STDIO.H 
string String to be output 
Returns A nonnegative value if successful; EOF if not 


Writes string to the standard output stream, stdout, replacing the string’s terminating null 
character (’\0’) with a newline character (\n) in the output stream. 
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putw 


qsort 


int putw( int binint, FILE *stream ); 


Include STDIO.H 

binint Binary integer to be output 

stream Pointer to target stream 

Returns The value written if successful; EOF may indicate an error 


Writes a binary value of type int to the current position of the stream. 
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void qsort( void *base, size_t num, size_t width, 
int( *compare )( const void *elem/, const void *“elem2 ) ); 


Include STDLIB.H, SEARCH.H 

base Start of array 

num Number of elements in array 

width Element size in bytes 

compare Comparison function 

eleml Pointer to key for the search 

elem2 Pointer to the array element to be compared with the key 
Returns No return value 


Implements a quick-sort algorithm to sort an array of num elements, each of width bytes. 
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raise 
int raise( int sig ); 
Include SIGNAL.H 
sig SIGABRT, SIGFPE, SIGILL, SIGINT, SIGSEGV, SIGTERM, 
SIGUSR1, SIGUSR2, SIGUSR3, SIGBREAK 
Returns O if successful; a nonzero value if not 
Raises the sig signal condition in the executing program. 
MANS! @ DOS #8 OS/2 OUNIX OC XENIX 
rand 
int rand( void ); 
Include STDLIB.H 
Returns A pseudorandom integer in the range 0 to RAND_ MAX 
Generates a pseudorandom number. 
MANS! @ DOS @ OS/2 MB UNIX” @ XENIX 
read 


int read( int handle, void *buffer, unsigned int count ); 


Include IO.H, ERRNO.H 

handle Handle referring to open file 

buffer Storage location for data 

count Maximum number of bytes 

Returns The number of bytes read if successful; —1 if not 
errno EBADF 


Attempts to read count bytes into buffer from the file associated with handle. 
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realloc 


_rectangle 


void *realloc( void *memblock, size_t size ); 


Include STDLIB.H or MALLOC.H 

memblock Pointer to previously allocated memory block 

size New size in bytes 

Returns veg pointer to the reallocated memory block if successful; NULL 
if no 


Changes the size and, possibly, the location of a previously allocated memory block. 
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short far rectangle( short control, short x/, short y/, short x2, short y2 y3 


Include GRAPH.H 

control _GFILLINTERIOR, GBORDER 

xl, yl Upper left corner 

x2, y2 Lower right corner 

Returns A nonzero value if anything is drawn; O if nothing is drawn 


Draws a rectangle with the current color, line style, and write mode, using the view coordi- 
nate system. 
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_reciangle_w 


short far _rectangle_w( short control, double wx/, double wy/, 


double wx2, double wy2 ); 
Include GRAPH.H 
control _GFILLINTERIOR, GBORDER 
wxl, wyl Upper left corner 
Wx2, wy2 Lower right corner 
Returns A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws a rectangle with the current color, line style, and write mode, using the window 
coordinate system. 
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_rectangle_wxy 


short far rectangle _wxy( short control, struct _wxycoord far *pwxy1, 
struct wxycoord far *pwxy2 ); 


Include GRAPH.H 

control _GFILLINTERIOR, GBORDER 

pwxyl Upper left corner 

pwxy2 Lower right corner 

Returns A nonzero value if anything is drawn; 0 if nothing is drawn 


Draws a rectangle with the current color, line style, and write mode, using the window 
coordinate system. 
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_registerfonts 


short far registerfonts( unsigned char _far “pathname ); 


Include GRAPH.H 
pathname Path name specifying .FON files to be registered 
Returns The number of fonts registered if successful; a negative value if not 


Initializes the font graphics system. Font files must be registered with the _registerfonts 
function before any other font-related library function can be used. 
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_remappalette 


short far remapallpalette( long far “colors ): 


Include GRAPH.H 
colors Array of color values 
Returns A nonzero value if successful; 0 if not 


Remaps all of the available colors simultaneously. 
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long far remappalette( short index, long color ); 


Include GRAPH.H 

index Color index to redefine 

color Color value to assign to index 

Returns The previous color value of index if successful; —1 if not 


Remaps the specified color index to color, which must be a color value supported by the 
current video configuration. 
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remove 
int remove( const char *filename ); 
Include STDIO.H or IO.H, ERRNO.H 
filename Path name of file to be removed 
Returns O if successful; a nonzero value if not 
errno EACCESS, ENOENT 
Deletes the file specified by filename. 
MANS! M@ DOS 8 OS/ OUNIX OO XENIX 
rename 
int rename( const char *oldname, const char *newname ); 
Include STDIO.H or IO.H, ERRNO.H 
oldname Pointer to old name 
newname Pointer to new name 
Returns 0 if successful; a nonzero value if not 
errno EACCESS, ENOENT, EXDEV 
Renames the file or directory specified by o/dname to the name given by newname. 
MANS! M@DOS 8 OS/2 OUNIX OC XENIX 
rewind 


void rewind( FILE *stream ); 


Include STDIO.H 
stream Pointer to target stream 
Returns No return value 


Repositions the file pointer associated with stream to the beginning of the file. 
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int rmdir( char *dirname ); 


Include DIRECT.H, ERRNO.H 

dirname Path name of directory to be removed 
Returns 0 if successful; a nonzero value if not 
errno EACCESS, ENOENT 


Deletes the directory specified by dirname. 
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int rmtmp( void ); 


Include STDIO.H 


Returns The number of temporary files closed and deleted 


Cleans up all the temporary files in the current directory. The function removes only those 
files created by tmpfile and should be used only in the same directory in which the tem- 
porary files were created. 
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unsigned int _rotl( unsigned int value, int shift ); 


Include STDLIB.H 

value Value to be rotated 

shift Number of bits to shift 

Returns value rotated to the left by shift bits 


Rotates bits to the left. 
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unsigned int rotr( unsigned int value, int shift ); 


Include STDLIB.H 

value Value to be rotated 

shift | Number of bits to shift 

Returns value rotated to the right by shift bits 


Rotates bits to the right. 
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int scanf( const char *format [, argument]... ); 


Include STDIO.H 
format Format-control string 
argument Optional arguments; pointers to variables of the types specified in 


the format-control string 


Returns The number of fields successfully converted and assigned; EOF if 
input failure occurs before any conversion 


Reads data from the standard input stream, stdin, into the locations given by an argument. 
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_scrolltextwindow 


_Searchenv 


segread 


void far _scrolltextwindow( short lines ); 


Include GRAPH.H 
lines Number of lines to scroll 
Returns No return value 


Scrolls the current text window. A positive value for lines scrolls the window up, and a 
negative value scrolls down. 
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void searchenv( char “filename, char *varname, char “pathname ); 


Include STDLIB.H 

filename Name of file to search for 
varname Environment to search 
pathname Buffer to store complete path 
Returns No return value 


Searches for the target file in the specified varname domain. 


O ANSI! @ DOS #8 OS/2 O UNIX OC XENIX 


void segread( struct SREGS *segregs ); 


Include DOS.H 
segregs Segment-register values 
Returns No return value 


Fills the structure pointed to by segregs with the current contents of the segment registers. 
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_Selectpalette 


short far selectpalette( short number ); 


Include GRAPH.H 
number Palette number 
Returns The previous palette number; —1 if an error occurs 


Selects one of several predefined palettes, depending on video mode and hardware 
(_MRES4COLOR, MRESNOCOLOR, and ORESCOLOR modes only). 
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_ setactivepage 


short far setactivepage( short page ); 


Include | GRAPH.H 

page Memory page number 

Returns The number of the previous active page if successful; —1 if an error 
occurs | 


Specifies the area in memory where output is written for hardware and mode configurations 
with enough memory to support multiple-screen pages. Note that OS/2 supports only one 
page. Page 0 is always supported. 
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_setbkcolor 


long far setbkcolor( long color ); 


Include GRAPH.H 
color Desired background color 
Returns The previous background color 


Sets the current background color to color. 


OANS| @DOS ® OS/2) OUNIX OF XENIX 


setbuf 


314 


Fe a RP RE Ge ao SET Eg ee ay Se a PR SI aR a a AG a Ec ES ce dS Na oe NE a 


setbuf 


_setcliprgn 


_setcolor 


void setbuf( FILE *stream, char *buffer ); 


Include STDIO.H 

stream Pointer to target stream 

buffer User-allocated buffer of size BUFSIZ or NULL for no buffering 
Returns No return value 


Allows the user to assign a buffer or disable buffering for stream. The argument stream 
must refer to an open file before it has been read or written. 
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void far _setcliprgn( short x/, short y/, short x2, short y2 ); 


Include GRAPH.H 

x1, yl Upper left corner of clip region 
x2, y2 Lower right corner of clip region 
Returns No return value; check _grstatus 


Limits the display of subsequent graphics output and font text output to the part that fits 
within a particular area of the screen, known as the clipping region. 
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short far setcolor( short color ); 


Include GRAPH.H 
color Desired color index 
Returns The previous color index if successful; —1 if not 


Sets the current color index (used by graphics and font text output) to color. 
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_Setfillmask 
void far _setfillmask( unsigned char far *mask ); 
Include GRAPH.H 
mask Mask array 
Returns No return value 
Sets the current fill mask. The mask is an 8-by-8 array of bits, where each bit represents a 
pixel. A 1 bit sets the corresponding pixel to the current color, whereas a 0 bit leaves the 
pixel unchanged. 
O ANSI DOS OOS/2 OUNIX OC XENIX 
_Setfont 
short far setfont( unsigned char far *options ); 
Include GRAPH.H 
options String describing font characteristics 
Returns The font index number if successful; a negative value if not 
Finds a single font from the set of registered fonts that has the characteristics specified by 
the options string and returns the index of that font. 
OANS! @ DOS OOS/2 OUNIX' CO XENIX 
_Setgtextvector 


struct xycoord far setgtextvector( short x, short y ); 


Include GRAPH.H 

x,y Values defining a vector that determines the direction of font text 
rotation 

Returns The previous vector in an xycoord structure defined in GRAPH.H 


Sets the current orientation for font text output. (0, 0) is ignored. 
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int setjmp( jmp_buf env ); 


Include SETJMP.H 

env Variable in which environment is stored 

Returns 0 after saving the stack environment; the value argument of longjmp 
if setjmp returns as a result of a longjmp call; 1 if the longjmp argu- 
ment is 0 


Saves a stack environment that can subsequently be restored using longjmp. Used together 
this way, setjmp and longjmp provide a way to execute a nonlocal goto. 
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void far _setlinestyle( unsigned short mask ); 


Include GRAPH.H 
mask Desired line-style mask 
Returns No return value 


Selects the mask used for line drawing. The mask is a 16-bit number, where each bit repre- 
sents a pixel in the line being drawn. If a bit is 1, the corresponding pixel is set to the cur- 
rent color. If a bit is 0, the corresponding pixel is left unchanged. 
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setlocale 
char *setlocale( int category, const char */ocale ); 
Include LOCALE.H 
category LC_ALL, LC_COLLATE, LC_TYPE, LC_ MONETARY, 
LC_NUMERIC, LC_TIME, NULL 
locale sc Onn 
Returns A pointer to the string associated with category for the new locale, if 
valid; a null pointer if invalid 
Sets categories specified for a certain location. 
mM ANS| @ DOS 8 OS/2 OUNIX OC XENIX 
setmode 


int setmode( int handle, int mode ); 


Include FCNTL.H, 10.H, ERRNO.H 

handle File handle 

mode O_TEXT, O_ BINARY 

Returns The previous translation mode if successful; —1 if not 
errno EBADF, EINVAL 


Sets the translation mode of the file given by handle to mode. 
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_setpixel 


_ setpixel_w 


_ Settexicolor 


short far _setpixel( short x, short y ); 


Include GRAPH.H 
x,y Target pixel 
Returns The previous value of the target pixel if successful; —1 if not 


Sets a pixel at the specified view coordinate location to the current color. 
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short far _setpixel_w( double wx, double wy ); 


Include GRAPH.H 
Wx, Wy Target pixel 
Returns The previous value of the target pixel if successful; —1 if not 


Sets a pixel at the specified window coordinate location to the current color. 
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short far _settextcolor( short index ); 


Include GRAPH.H 
index Desired color index 
Returns The color index of the previous text attribute 


Sets the current text attribute to the color index specified by index. 
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_ settexicursor 


short far settextcursor( short attr ); 


Include GRAPH.H 
attr 0x0707, 0x0007, 0x0607, 0x2000, etc. 
Returns The previous cursor attribute if successful; —1 if not 


In text modes, sets the BIOS cursor attribute (the shape) to the value specified by attr. 
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_Settextposition 


struct recoord far settextposition( short row, short column ); 


Include GRAPH.H 
row, column New text output start position 
Returns The previous text position 


Sets the current text position to the location (row, column) within the current text window. 
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_ settextrows 


short far _settextrows( short rows ); 


_ Include GRAPH.H 
rows Number of text rows requested 
Returns The number of rows actually set if successful; 0 if an unexpected 


error occurs 
Requests the number of text rows to be used in the current video mode. 
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_ Settextwindow 


setvbuf 


void far settextwindow( short r/, short cl, short 72, short c2 ); 


Include GRAPH.H 

rl,cl Upper left corner of window 
r2,c2 Lower right corner of window 
Returns No return value; check _ grstatus 


Specifies a window in row and column coordinates where all the text output to the screen is 
confined. 
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int setvbuf( FILE “stream, char *buffer, int mode, size_t size ); 


Include STDIO.H 

stream Pointer to target stream 

buffer User-supplied buffer or NULL 

mode _IOFBF, IOLBF, IONBF 

Size Size of buffer 

Returns 0 if successful; a nonzero value if not 


Allows the user to control both buffering and buffer size for stream. 
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_setvideomode 
short far setvideomode( short mode ); 


Include GRAPH.H 


mode _MAXRESMODE, MAXCOLORMODE, DEFAULTMODE, 
_TEXTBW40, _TEXTC40, _TEXTBWS80, TEXTC80, 
~MRES4COLOR, _MRESNOCOLOR, _HRESBW, TEXTMONO, 
_HERCMONO, _MRES16COLOR, _HRES16COLOR, 
_ERESNOCOLOR, _ERESCOLOR, VRES2COLOR, 
_VRES16COLOR, _MRES256COLOR, _ORESCOLOR 


Returns The number of text rows if successful; 0 if not 


Selects a screen mode appropriate for a particular hardware/display configuration. Only 
text modes are available in OS/2. 
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_setvideomoderows 


short far setvideomoderows( short mode, short rows ); 


Include GRAPH.H 
mode MAXRESMODE, MAXCOLORMODE, DEFAULTMODE, 


TEXTBW40, TEXTC40, TEXTBW80, TEXTC80, 


MRES4COLOR, _MRESNOCOLOR, _HRESBW, _TEXTMONO, 


_HERCMONO, _MRES16COLOR, _HRESI6COLOR, 
_ERESNOCOLOR, _ERESCOLOR, VRES2COLOR, 
_VRES1I6COLOR, _MRES256COLOR, _ORESCOLOR 


rows Number of text rows requested 


Returns The number of rows actually set if successful; O if not 


Selects a screen mode for a particular hardware/display combination, and requests the num- 
ber of text rows to be used. Only text modes are available in OS/2. 
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_Setvieworg 


_Setviewport 


struct xycoord far _setvieworg( short x, short y ); 


Include GRAPH.H 
Bo New origin point 
Returns The physical coordinates of the previous view origin 


Moves the viewport origin (0, 0) to the physical point (x, y). (AI other view coordinate 
points move the same direction and distance.) 
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void far setviewport( short x/, short y/, short x2, short y2 ); 


Include GRAPH.H 

xl, yl Upper left corner of viewport 

be Lower right corner of viewport 
Returns No return value; check _grstatus 


Redefines the graphics viewport (the active drawing area within the boundaries of the 
physical screen). 
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_setvisualpage 


short far setvisualpage( short page ); 


Include GRAPH.H 
page Visual page number 
Returns The number of the previous visual page if successful; a negative 


value if not 


Specifies the area in memory where output is displayed for hardware and mode configura- 
tions with enough memory to support multiple-screen pages. Note that OS/2 supports only 
one page. Page 0 is always supported. 
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_setwindow 
short far setwindow( short finvert, double wx/, double wy/, 
double wx2, double wy2 ); 
Include GRAPH.H 
finvert Invert flag 
wxl, wyl Upper left corner of window 
wx2, wy2 Lower right corner of window 
Returns A nonzero value if successful; 0 if not 


Defines a virtual window bounded by the specified coordinates within the current viewport. 
All w and wxy drawing functions produce output relative to this window. 
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_setwritemode 


signal 


short far setwritemode( short action ); 


Include GRAPH.H 
action _GPSET, GPRESET, GAND, GOR, GXOR 
Returns The previous write mode; —1 if an error occurs 


Sets the current logical write mode used when drawing lines with the lineto, rectangle, 


and polygon functions. 
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void( *signal( int sig, void( *func)( int sig [[, int subcode] ) ) )( int sig ); 


Include SIGNAL.H, ERRNO.H 

sig SIGABRT, SIGBREAK, SIGFPE, SIGILL, SIGINT, SIGSEGV, 
SIGTERM, SIGUSR1, SIGUSR2, SIGUSR3 

func Function address or one of SIG_IGN, SIG_DFL, SIG_SGE, SIG_ACK 

subcode Optional subcode to the signal number 

Returns The previous value of func associated with the given signal if 


successful; —1 if not 
errno EINVAL 


Allows a process to choose one of several ways to handle an interrupt signal from the oper- 


ating system. 
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sinh! 


sinhl 


double sin( double x ); 

Include MATH.H, ERRNO.H 
x Angle in radians 
Returns The sine of x 

errno ERANGE 


Calculates the sine of x. 
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double sinh( double x ); 

Include MATH.H, ERRNO.H 

x Angle in radians 

Returns The hyperbolic sine of x; + HUGE_VAL if not 
errno ERANGE 


Calculates the hyperbolic sine of x. 
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long double sinhi( long double x ); 


Include MATH.H, ERRNO.H 

x Angle in radians 

Returns The hyperbolic sine of x if successful; + LHUGE_VAL if not 
errno ERANGE 


Calculates the hyperbolic sine of x. Long double-precision floating-point version of sinh. 
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long double sinl( long double x ); 


Include MATH.H, ERRNO.H 
x Angle in radians 
Returns The sine of x 

errno ERANGE 


Calculates the sine of x. Long double-precision floating-point version of sin. 
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int sopen( char *filename, int oflag, int shflag [[, int pmode] ); 


Include SYS\TYPES.H, SYS\STAT.H, FCNTL.H, SHARE.H, IO.H 

filename File path name 

oflag O_APPEND, O_BINARY, O_CREAT, O EXCL, O_RDONLY, 
O_RDWR, O_ TEXT, O_TRUNC, 0 WRONLY 

shflag SH_COMPAT, SH_DENYRW, SH_DENYWR, SH_DENYRD, 
SH _DENYNO 

pmode S_IWRITE, S TREAD, S IREAD |S TWRITE 

Returns A file handle for the opened file if successful; —1 if not 

errno EACCES, EEXIST, EINVAL, EMFILE, ENOENT 


Opens the file specified by filename and prepares the file for subsequent shared reading or 
writing, as defined by oflag, shflag, and, optionally, pmode. 
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spawnle 


int spawnl( int mode, char *cmdname, char *arg0, char “arg/, ... char *argn, NULL ); 


Include STDIO.H, PROCESS.H, ERRNO.H 

mode P WAIT, P_ NOWAIT, P_ NOWAITO, P_OVERLAY, P_DETACH 

cmdname Path name of file to be executed 

arg0, ... argn List of pointers to arguments, terminated by NULL 

Returns The exit status of the child process (synchronous spawn) or the 
process ID of the child process (asynchronous spawn) 

errno E2BIG, EINVAL, ENOENT, ENOEXEC, ENOMEM 


Creates and executes a new child process, and passes a copy of the current process’s en- 
vironment to the child. Command-line arguments are passed individually to the function. 
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int spawnle( int mode, char *cmdname, char *arg0, char *arg/, ... char “argn, NULL, 
char **envp ); 


Include STDIO.H, PROCESS.H, ERRNO.H 

mode P_ WAIT, P NOWAIT, P_ NOWAITO, P_OVERLAY, P_DETACH 

cmdname Path name of file to be executed 

arg0, ... argn List of pointers to arguments, terminated by NULL 

envp Array of pointers to environment settings 

Returns The exit status of the child process (synchronous spawn) or the 
process ID of the child process (asynchronous spawn) 

errno E2BIG, EINVAL, ENOENT, ENOEXEC, ENOMEM 


Creates and executes a new child process. Command-line arguments are passed individu- 
ally to the function. The child process is passed an array of pointers to environment strings 
instead of a copy of the current process’s environment strings. 
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spawnlp 

int spawnlp( int mode, char *cmdname, char *arg0, char *arg/, ... char *argn, 

NULL ); 

Include STDIO.H, PROCESS.H, ERRNO.H 

mode P_WAIT, P_NOWAIT, P NOWAITO, P_OVERLAY, P_ DETACH 

cmdname Path name of file to be executed 

arg0, ... argn List of pointers to arguments, terminated by NULL 

Returns The exit status of the child process (synchronous spawn) or the 

process ID of the child process (asynchronous spawn) 
errno E2BIG, EINVAL, ENOENT, ENOEXEC, ENOMEM 


Creates and executes a new child process, and passes to the child a copy of the environment 
of the current process. Command-line arguments are passed individually to the function. 
The PATH environment variable is used to find the file to be executed if a relative path 
name is given. 
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spawnv 
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spawnlpe 


spawnv 


int spawnlpe( int mode, char *cmdname, char *arg0, char *arg/, ... char “argn, NULL, 
char **envp ); 


Include STDIO.H, PROCESS.H, ERRNO.H 

mode P WAIT, P NOWAIT, P_NOWAITO, P_OVERLAY, P_DETACH 

cmdname Path name of file to be executed 

arg0, ... argn List of pointers to arguments, terminated by NULL 

envp Array of pointers to environment settings 

Returns The exit status of the child process (synchronous spawn) or the 
process ID of the child process (asynchronous spawn) 

errno E2BIG, EINVAL, ENOENT, ENOEXEC, ENOMEM 


Creates and executes a new child process. Command-line arguments are passed individu- 
ally to the function. The PATH environment variable is used to find the file to be executed 
if it is specified by a relative path name. The child process is passed an array of pointers to 
environment strings, instead of a copy of the environment strings of the current process. 
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int spawnv( int mode, char *cmdname, char **argv ); 


Include STDIO.H, PROCESS.H, ERRNO.H 

mode P_ WAIT, P NOWAIT, P_NOWAITO, P_OVERLAY, P_DETACH 

cmdname Path name of file to be executed 

argv Array of pointers to arguments 

Returns The exit status of the child process (synchronous spawn) or the 
process ID of the child process (asynchronous spawn) 

errno E2BIG, EINVAL, ENOENT, ENOEXEC, ENOMEM 


Creates and executes a new child process, and passes a copy of the current process’s en- 
vironment to the child. Command-line arguments are passed to the function as an array of 
pointers. 
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spawnve 
int spawnve( int mode, char *cmdname, char **aregv , char **envp ); 
Include STDIO.H, PROCESS.H, ERRNO.H 
mode P_WAIT, P_ NOWAIT, P_NOWAITO, P_OVERLAY, P_DETACH 
cmdname Path name of file to be executed 
argv Array of pointers to arguments 
envp Array of pointers to environment settings 
Returns The exit status of the child process (synchronous spawn) or the 
process ID of the child process (asynchronous spawn) 
errno E2BIG, EINVAL, ENOENT, ENOEXEC, ENOMEM 
Creates and executes a new child process. Command-line arguments are passed to the func- 
tion as an array of pointers. The child process is passed an array of pointers to environment 
strings, instead of a copy of the environment strings of the current process. 
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int spawnvp( int mode, char *cmdname, char **argyv ); 


Include STDIO.H, PROCESS.H, ERRNO.H 

mode P_WAIT, P_NOWAIT, P_NOWAITO, P_OVERLAY, P_ DETACH 

cmdname Path name of file to be executed 

argv Array of pointers to arguments 

Returns The exit status of the child process (synchronous spawn) or the 
process ID of the child process (asynchronous spawn) 

errno E2BIG, EINVAL, ENOENT, ENOEXEC, ENOMEM 


Creates and executes a new child process, and passes a copy of the current process’s en- 
vironment to the child. Command-line arguments are passed to the function as an array of 
pointers. The PATH environment variable is used to find the file to be executed if necessary 
and if the file is specified by a relative path name. 
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spawnvpe 


_Splitpath 


int spawnvpe( int mode, char *cmdname, char **argv, char **envp ); 


Include STDIO.H, PROCESS.H, ERRNO.H 

mode P WAIT, P_NOWAIT, P_ NOWAITO, P_OVERLAY, P_ DETACH 

cmdname Path name of file to be executed 

argv Array of pointers to arguments 

envp Array of pointers to environment settings 

Returns The exit status of the child process (synchronous spawn) or the 
process ID of the child process (asynchronous spawn) 

errno E2BIG, EINVAL, ENOENT, ENOEXEC, ENOMEM 


Creates and executes a new child process. Command-line arguments are passed to the func- 
tion as an array of pointers. The PATH environment variable is used to find the file to be ex- 
ecuted. It explicitly passes to the child process the strings, instead of a copy of the current 
process’s environment strings array of pointers to environment. 
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void splitpath( char *path, char *drive, char *dir, char *fname, char “ext ); 
= p 


Include STDLIB.H 

path Full path-name buffer 
drive Drive letter 

dir Directory path 

fname File name 

ext File extension 
Returns No return value 


Breaks the full path-name buffer path into its four components. 
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sprintf 


sqrt 


int sprintf( char *buffer, const char *format |, argument]... ); 


Include 
buffer 
format 


argument 


Returns 


STDIO.H 
Storage location for output 
Format-control string 


Optional arguments; pointers to variables of the types specified in 
the format-control string 


The number of characters stored in buffer, not counting the terminat- 
ing null character (’\0’) 


Formats and stores a series of characters and values in buffer. 
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double sqrt( double x ); 


Include 
x 
Returns 


errno 


MATH.H, ERRNO.H 
Nonnegative floating-point value 
The square root of x if successful; 0 if not 


EDOM 


Calculates the square root. 
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srand 


Srand 


long double sqrtl( long double x ); 


Include MATH.H, ERRNO.H 

~ Nonnegative long double-precision floating-point value 
Returns The square root of x if successful; 0 if not 

errno EDOM 


Calculates the square root. Long double-precision floating-point version of sqrt. 
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void srand( unsigned int seed ); 


Include STDLIB.H 
seed Seed for random-number generation 
Returns No return value 


Sets the starting point for generating a series of pseudorandom integers. 
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sscant 
int sscanf( const char “buffer, const char *format [, argument]... ); 
Include STDIO.H 
buffer Stored data 
format Format-control string 
argument | Optional arguments; pointers to variables of types specified in the 
format-control string 
Returns The number of fields that were successfully converted and assigned 
Reads data from buffer into the locations given by each argument. Every argument must be 
a pointer to a variable with a type that corresponds to a type specifier in format. 
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size_t stackavail( void ); 


Include MALLOC.H 


Returns The size in bytes as an unsigned integer 


Gets the approximate size in bytes of the stack space available for dynamic memory alloca- 
tion with alloca. 
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Stat 
int stat( char *pathname, struct stat *buffer ); 
Include SYS\STAT.H, SYS\TYPES.H, ERRNO.H 
pathname Path name of existing file 
buffer Pointer to structure to receive results 
Returns O if successful; a nonzero value if not 
errno ENOENT 
Gets information about the file or directory specified by pathname and stores it in the struc- 
ture that buffer points to. 
O ANS! m@ DOS 8 OS/2 UNIX’ @f XENIX 
_Statusé87 
unsigned int _status87( void ); 
Include FLOAT.H 
Returns A floating-point status word whose bits are defined in FLOAT.H 
Gets the current 8087 floating-point status word. 
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char *streat( char *string/, const char *string2 ); 


Include STRING.H 

string] Destination string 

string2 Source string 

Returns A pointer to the beginning of the concatenated string 


Appends string2 to string!. 
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strehr 
char *strchr( const char *string, int c ); 
Include STRING.H 
string Source string 
C Character to be located 
Returns A pointer to the first occurrence of c in string 
Searches for the first occurrence of c in string. 
MANS! @ DOS #8 OS/2 MWUNIX’ Mi XENIX 
stremp 
int stremp( const char *string/, const char *string2 ); 
Include STRING.H 
stringl, string2 Strings to compare 
Returns A value less than, equal to, or greater than 0, depending on whether 
the string pointed to by string/ is less than, equal to, or greater than 
the string pointed to by string2 
Compares two strings. 
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int strcoll( const char *string/, const char *string2 ); 


Include STRING.H 
string], string2 Strings to compare 
Returns A value less than, equal to, or greater than 0, depending on whether 


the string pointed to by string/ 1s less than, equal to, or greater than 
the string pointed to by string2 


Compares two strings for locale-specific collating sequences. 
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sircpy 
char *strepy( char *string/, const char *string2 ); 
Include STRING.H 
string] Destination string 
string2 Source string 
Returns string 
Copies string2 to string1. 
MANS! @ DOS 8 OS/2 WM UNIX’ lf XENIX 
strespn 
size_t strespn( const char “string/, const char *string2 ); 
Include STRING.H 
stringl Source string 
string2 Character set 
Returns The length of the maximum initial segment of string/ that consists of 
characters not in string2 
Finds first substring in string/ of characters not in string2. 
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char *_strdate( char “datestr ); 


Include TIME.H 
datestr Current date 
Returns A pointer to the date 


Copies the current date to the buffer that datestr points to, formatted as mm/dd/yy. 
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char “strdup( const char “string ); 


Include STRING.H 
string Source string 
Returns A pointer to the storage space containing the duplicate string 


Duplicates string, copying it to memory allocated by malloc. 
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char *strerror( int errnum ); 


Include STRING.H 
errnum Error number 
Returns A pointer to the error-message string 


Maps errnum to an error-message string, returning a pointer to the string. 
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char *_strerror( char “string ); 


Include STRING.H 
string User-supplied message 
Returns No return value 


Returns a pointer to a string containing, in order, the string message, a colon, a space, the 
system error message for the last library call producing an error, and a newline character. 
The supplied string message can be a maximum of 94 bytes long. 
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sirftime 
size_t strftime( char “string, size_t maxsize, const char *format, 
const struct tm *timeptr ); 
Include TIME.H 
string Output string 
maxsize Maximum length of string 
format Format-control string 
timeptr tm data structure 
Returns The number of characters placed in string if the total number, includ- 
ing the terminating null character (’\0’), is less than maxsize; 0 
otherwise 
Copies text into a string related to date and time values from a tm structure and specified 
by format. 
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int stricmp( const char *string/, const char *string2 ); 


Include STRING.H 
string], string2 Strings to compare 
Returns A value less than, equal to, or greater than 0, depending on whether 


the string pointed to by string/ is less than, equal to, or greater than 
the string pointed to by string2 


Compares two strings without regard to case. 
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Strlen 
size_t strlen( const char *string ); 
Include STRING.H 
string Null-terminated string 
Returns The length in bytes of string, not including the terminating null char- 
acter (’\0’) 
Gets the length of a string. 
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char “strlwr( char *string ); 


Include STRING.H 
string String to be converted 
Returns A pointer to the converted string 


Converts any uppercase letters in the given null-terminated string to lowercase. Other char- 
acters are not affected. 
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sirncat 
char “strncat( char *string/, const char *string2, size_t count ); 
Include STRING.H 
string] Destination string 
string2 Source string 
count Maximum number of characters to append 
Returns A pointer to the concatenated string 
Appends, at most, the first count characters of string2 to string] and terminates the result- 
ing string with a null character (’\0’). 
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int strncmp( const char “string, const char *string2, size_t count ); 


Include STRING.H 

string], string2 Strings to compare 

count Maximum number of characters to compare 

Returns A value less than, equal to, or greater than 0, depending on whether 


the string pointed to by string/ is less than, equal to, or greater than 
the string pointed to by string2 


Compares, at most, the first count characters of string] and string2. 
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strncpy 
char *strncpy( char “string/, const char *string2, size_t count ); 
Include STRING.H 
string Destination string 
string2 Source string 
count Number of characters copied 
Returns string] 
Copies, at most, count characters of string2 to string]. If string2 is shorter than count, null 
(°\0’) characters are appended to string]. Warning: If the sum of the lengths of string/ and 
string2 is longer than count, no null character will be appended. 
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int strnicmp( const char *string/, const char *string2, size_t count ); 


Include STRING.H 

string], string2 Strings to compare 

count Maximum number of characters compared 

Returns A value less than, equal to, or greater than 0, depending on whether 


the string pointed to by string! is less than, equal to, or greater than 
the string pointed to by string2 


Compares, at most, the first count characters of string! and string2, without regard to 
letter case. 
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sirnset 
char “strnset( char *string, int c, size_t count ); 
Include STRING.H 
string String to be initialized 
% Character setting 
count Maximum number of characters set 
Returns A pointer to the altered string 
Sets, at most, the first count characters of string to the character c. If count is longer than 
string, the length of string replaces count. 
O ANS! @ DOS ® OS/2 OUNIX' OC XENIX 
strpbrk 
char “strpbrk( const char *string/, const char *string2 ); 
Include STRING.H 
string] Source string 
string2 Character set 
Returns A pointer to the first occurrence of any character from string2 in 
string] 


Finds the first occurrence in string] of any character from string2, not including the termi- 
nating null character (’\0’). 
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strrehr 
char “strrchr( const char *string, int c ); 
Include STRING.H 
string String to be searched 
C Character to be located 
Returns A pointer to the last occurrence of c in string; a null pointer if c is 
not found 
Finds the last occurrence of the character c in string. 
mANS| @ DOS #8 OS/2 BM UNIX” Wf XENIX 
strrev 
char *“strrev( char *string ); 
Include STRING.H 
string String to be reversed 
Returns A pointer to the altered string 
Reverses the order of the characters in string. The terminating null character (’\0’) remains 
in place. 
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char “strset( char *string, int c ); 


Include STRING.H 

string String to be set 

C Character setting 

Returns A pointer to the altered string 


Sets all of the characters of string to c, except the terminating null character (’\0’). 
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sirspn 
size_t strspn( const char *string/, const char *string2 ); 
Include STRING.H 
string] Searched string 
string2 Character set 
Returns The length of the initial substring of string/ that consists entirely of 
characters from string2 
Finds the first substring and returns the index of the first character in string] that does not 
belong to the set of characters specified by string2. 
MANS! @ DOS #8 OS/2 MUNIX” Bi XENIX 
Sirstr 
char *strstr( const char *string/, const char *string2 ); 
Include STRING.H 
string Searched string 
string2 String to search for 
Returns A pointer to the first occurrence of string2 in string]; NULL if 
string2 is not found 
Finds a substring. 
MANS! MDOS WOS/ OUNIX CO XENIX 
_Sirtime 


char *_strtime( char *zimesitr ); 


Include TIME.H 
timestr Time string 
Returns A formatted string 


Copies the current time into the buffer that timestr points to, formatted as hh:mm:ss. 
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sirtod 
double strtod( const char *nptr, char **endptr ); 
Include | STDLIB.H, ERRNO.H 
nptr String to convert 
endptr Pointer to the character causing the end of scan 
Returns The value of the floating-point number if successful; + HUGE_VAL 
on overflow; 0 otherwise 
errno ERANGE 
Converts a character string to a double-precision value. 
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char *strtok( char *string/, const char *string2 ); 


Include STRING.H 

string] String containing token(s) 

string2 Set of delimiter characters 

Returns A pointer to the first token in string]; successive calls against the 


same string return the subsequent tokens in the string 


Reads string] as a series of zero or more tokens and string2 as the set of characters serving 
as delimiters of the tokens in string]. Inserts a null character each time it is called, modify- 
ing string !. 
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Sirtol 
long strtol( const char *nptr, char **endptr, int base ); 
Include STDLIB.H, ERRNO.H 
nptr String to convert 
endptr Pointer to the character causing the end of scan 
base Number base to use 
Returns The value represented in the string if successful; LONG MAX or 
LONG MIN on overflow; 0 otherwise 
errno ERANGE 
Converts a character string to a long-integer value. 
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long double _strtold( const char *nptr, char **endptr ); 


Include STDLIB.H, ERRNO.H 

nptr String to convert 

endptr Pointer to the character causing the end of scan 

Returns The long double-precision value of the floating-point number if 
successful; + LHUGE_VAL on overflow; 0 otherwise 

errno ERANGE 


Converts a character string to a long double-precision floating-point value. 
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sirtoul 


strupr 


unsigned long strtoul( const char *nptr, char **endptr, int base ); 


Include STDLIB.H, ERRNO.H 

nptr String to convert 

endptr Pointer to the character causing the end of scan 

base Number base to use 

Returns The converted value if successful; ULONG_MAX on overflow; 
0 otherwise 

errno ERANGE 


Converts a character string to an unsigned-long-integer value. 


MANS! @ DOS 8 OS/2 OUNIX OC XENIX 


char *strupr( char *string ); 


Include STRING.H 
string String to be capitalized 
Returns A pointer to the converted string 


Converts any lowercase letters in string to uppercase. Other characters are not affected. 
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size_t strxfrm( char “string/, const char *string2, size_t count ); 


Include STRING.H 

string] Result string 

string2 Source string 

count Number of characters transformed 

Returns The length of the transformed string, excluding the terminating null 
character (’\0’). 


Transforms the string pointed to by string2 into a new form, based on locale-specific 
information and stores the result in string/. 
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void swab( char *source, char *dest, int n ); 


Include STDLIB.H 

source Data to be copied and swapped 
dest Storage location for swapped data 
n Number of bytes copied 

Returns No return value 


Copies n bytes from source, swaps each pair of adjacent bytes, and stores the result at dest. 
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system 
int system( const char *command ); 
Include PROCESS.H, STDLIB.H, ERRNO.H 
command Command to be executed 
Returns A nonzero value if command is NULL and the command interpreter 
is found; otherwise, the return code from spawning the command 
interpreter 
errno E2BIG, ENOENT, ENOEXEC, ENOMEM 
Passes command to the command interpreter and executes the string as an operating system 
command. 
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double tan( double x ); 

Include MATH.H, ERRNO.H 

x Angle in radians 

Returns The tangent of x if successful; 0 if not 
errno ERANGE 


Calculates the tangent of x. 
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double tanh( double x ); 

Include MATH.H 

x Angle in radians 

Returns The hyperbolic tangent of x 


Calculates the hyperbolic tangent of x. 
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long double tanhi( long double x ); 


Include MATH.H 
x Angle in radians 
Returns The hyperbolic tangent of x 


Calculates the hyperbolic tangent of x. Long double-precision floating-point version 
of tanh. 
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long double tanl( long double x ); 


Include MATH.H, ERRNO.H 

x Angle in radians 

Returns The tangent of x if successful; 0 if not 
errno ERANGE 


Calculates the tangent of x. Long double-precision floating-point version of tan. 
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long tell( int handle ); 


Include IO.H, ERRNO.H 

handle Handle referring to open file 

Returns The current position of the file pointer (if any) associated with 
handle if successful; —1L if not 

errno EBADF 


Gets the current position of any file pointer associated with handle. 
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char *tempnam( char “dir, char “prefix ); 


Include STDIO.H 

dir Target directory if TMP environment variable not defined 
prefix File-name prefix 

Returns A pointer to the name generated if successful; NULL if not 


Creates a temporary file in another directory. 


QO ANS! @ DOS @OS/2 MUNIX @ XENIX 


353 impnam 


time 
time_t time( time_t *timer ); 
Include TIME.H 
timer Storage location for time 
Returns The time in elapsed seconds 
Returns the number of seconds elapsed since 00:00:00 Greenwich mean time (GMT), 
January 1, 1970, according to the system clock. 
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tmpfile 
FILE *tmpfile( void ); 
Include STDIO.H 
Returns A stream pointer if successful; a null pointer if not 
Creates a temporary file and returns a stream pointer to that file. 
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impnam 


char *tmpnam( char *string ); 


Include STDIO.H 
string Pointer to temporary name 
Returns A pointer to the name generated if successful; NULL if not 


Generates a string that can be used as the name of a temporary file. 
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toascii 


tolower 


_tolower 


int toascii( int c ); 


Include CTYPE.H 
C Character to be converted 
Returns The converted character 


Sets all but the low-order 7 bits of c to 0, so that the converted value represents a character 
in the ASCII character set. If c already represents an ASCII character, c is unchanged. 
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int tolower( int c ); 


Include CTYPE.H 
e Character to be converted 
Returns The lowercase character corresponding to c 


Converts c to lowercase if c represents an uppercase letter. Otherwise, c is unchanged. 
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int tolower( int c ); 


Include CTYPE.H 
C Character to be converted 
Returns The lowercase character corresponding to c 


Converts c to lowercase. To be used only if c is known to be an uppercase letter. The result 
is undefined if c is not an uppercase letter. 
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toupper 


_toupper 


izset 


int toupper( int c ); 


Include CTYPE.H 
C Character to be converted 
Returns The uppercase character corresponding to c 


Converts c to uppercase if c represents a lowercase letter. Otherwise, c is unchanged. 
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int toupper( int c ); 


Include CTYPE.H 
C Character to be converted 
Returns The uppercase character corresponding to c 


Converts c to uppercase. To be used only if c is known to be a lowercase letter. The result is 
undefined if c is not a lowercase letter. 
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void tzset( void ); 


Include TIME.H 


Returns No return value 


Using the current setting of the environment variable TZ, assigns values to the global varia- 
bles daylight, timezone, and tzname, which are used by the ftime and localtime func- 
tions to make corrections from GMT to local time, and by time to compute GMT from 
system time. 
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char “ultoa( unsigned long value, char “string, int radix ); 


Include STDLIB.H 

value Number to be converted 
string String result 

radix Base of value 

Returns A pointer to string 


Converts the digits of value to a null-terminated character string and stores the result (up to 
33 bytes) in string. 
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int umask( int pmode ); 


Include SYS\TYPES.H, SYS\STAT-H, 10.H 
pmode S IWRITE, S IREAD 
Returns The previous value of pmode 


Sets the file-permission mask of the current process to the mode specified by pmode. The 
file-permission mask is used to modify the permission setting of new files created by creat, 
open, or sopen. 
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int ungetc( int c, FILE “stream ); 


Include STDIO.H 

6 Character to be pushed 

stream Pointer to target stream 

Returns The character argument c if successful; EOF if not 


Pushes the character c back onto the input stream and clears the end-of-file indicator. A sub- 
sequent read operation on the stream begins with c. 
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int ungetch( int c ); 


Include CONIO.H 
C Character to be pushed 
Returns The character argument c if successful; EOF if not 


Pushes the character c back to the console, causing c to be the next character read by getch 
or getche. 
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int unlink( const char *filename ); 


Include IO.H or STDIO.H, ERRNO.H 
filename Path name of file to be removed 
Retur.us O if successful; —1 if not 

errno EACCESS, ENOENT 


Deletes the file specified by filename. 
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_unregisterfonts 


utime 


void far _unregisterfonts( void ); 


Include GRAPH.H 


Returns No return value 
Frees memory previously allocated and used by the _registerfonts function. The 
_unregisterfonts function removes the header information for all fonts and unloads 


the currently selected font data from memory. 
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int utime( char *filename, struct utimbuf *times ); 


Include SYS\TYPES.H, SYS\UTIME.H, ERRNO.H 
filename File path name 

times Pointer to stored time values 

Returns O if successful; —1 if not 

errno EACCESS, EINVAL, EMFILE, ENOENT 


Sets the modification time for the file specified by filename. 
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va_end 


type va_arg( va_list arg ptr, type ); 


Include STDARG.H (ANSD or VARARGS.H (UNIX) 

type Type of argument to be retrieved 

arg ptr Pointer to list of arguments 

va_alist Name of parameter to called function (UNIX version only) 
va_ del Declaration of va_alist (UNIX version only) 

Returns The current argument 


Retrieves a value of type from the location given by arg_ptr. Note that va_list is defined as 
the type of va_alist. 
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void va_end( va_list arg ptr); 


Include STDARG.H or VARARGS.H 

arg ptr Pointer to list of arguments 

va_alist Name of parameter to called function (UNIX version only) 
va_dcl Declaration of va_alist (UNIX version only) 

Returns No return value 


Resets arg_ptr to NULL. Note that va_list is defined as the type of va_alist. 
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va_Start 


vfprintt 


void va_start( va_list arg _ptr ); (UNIX version) 


void va_start( va_list arg_ptr, prev_param ); (ANSI version) 


Include STDARG.H or VARARGS.H | 
arg ptr Pointer to list of arguments 

prev_param Parameter preceding first optional argument (ANSI version only) 
va_alist Name of parameter to called function (UNIX version only) 

va_dcl Declaration of va_alist (UNIX version only) 

Returns No return value 


Sets arg ptr to beginning of list of optional arguments passed to the function used before 
va_arg. Note that va_list is defined as the type of va_alist. 
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int vfprintf( FILE “stream, const char *format, va_list argptr ); 


Include STDARG.H or VARARGS.H, STDIO.H 

stream Pointer to target stream 

format Format control string 

argptr Pointer to list of arguments 

Returns ae ere of characters written if successful; a negative value 
if no 


Formats and outputs data to stream. 
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vprintt 


vsprintf 


int vprintf( const char “format, va_list argptr ); 


Include 
format 
areptr 


Returns 


STDARG.H or VARARGS.H, STDIO.H 
Format control string 
Pointer to list of arguments 


The number of characters written, not counting the terminating null 
character (’\0’), if successful; a negative value if not 


Formats and outputs data to the standard output stream, stdout. 
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int vsprintf( char “buffer, const char *format, va_list argptr ); 


Include 
buffer 
format 
argptr 


Returns 


STDARG.H or VARARGS.H, STDIO.H 
Storage location for output 

Format control string 

Pointer to list of arguments 


The number of characters written, not counting the terminating null 
character (’\0’), if successful; a negative value if not 


Formats and outputs data to buffer. 
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int wait( int *termstat ); 


Include PROCESS.H, ERRNO.H 
termstat Child process termination status and return code buffer 
Returns The child process identification if returning after normal child 


process termination; —1 if returning after abnormal child process ter- 
mination; or —1 immediately otherwise 


errno ECHILD, EINTR 
Suspends the calling process until any of the caller’s immediate child processes terminate. 


If all of the caller’s children have terminated before it calls the wait function, the function 
returns immediately. 
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short far wrapon( short option ); 


Include GRAPH.H 
option _GWRAPOFF, GWRAPON 
Returns The previous value of option 


Controls whether text output with the outtext and _outmem functions wraps to a new line 
or is simply truncated when the text output reaches the edge of the current text window. 
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write 
int write( int handle, void *buffer, unsigned int count ); 
Include 10.H, ERRNO.H 
handle Handle referring to open file 
buffer Data to be written 
count Number of bytes 
Returns The number of bytes actually written if successful; —1 if not 
errno EBADF, ENOSPC 
Writes count bytes from buffer into the file associated with handle. The write operation 
begins at the current position in the file. If the file is open for appending, the operation 
begins at the current end of the file. 
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double yn( int n, double x ); 


Include MATH.H, ERRNO.H 

n Integer order 

x Floating-point value 

Returns The result of a Bessel function of x; -HUGE_VAL if x is negative 
errno EDOM 


Returns the Bessel function of the second kind (order 7). 
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long double _ynl( int 7, long double x ); 


Include MATH.H, ERRNO.H 

n Integer order 

x Long double-precision floating-point value 

Returns The result of a Bessel function of x; -_LHUGE_VAL if x is negative 
errno EDOM 


Returns the Bessel function of the second kind (order n). Long double-precision floating- 
point version of yn. 
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double y1( double x ); 

Include MATH.H, ERRNO.H 

x Floating-point value 

Returns The result of a Bessel function of x; -HUGE_VAL if x is negative 
errno EDOM 


Returns the Bessel function of the second kind (order 1). 
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long double _yll( long double x ); 


Include MATH.H, ERRNO.H 

x Long double-precision floating-point value 

Returns The result of a Bessel function of x; -_LHUGE_VAL if x is negative 
errno EDOM 


Returns the Bessel function of the second kind (order 1). Long double-precision floating- 
point version of y1. 
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double y0( double x ); 

Include MATH.H, ERRNO.H 

x Floating-point value 

Returns The result of a Bessel function of x; -HUGE_VAL if x is negative 
errno EDOM 


Returns the Bessel function of the second kind (order 0). 
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long double _y0l( long double x ); 


Include MATH.H, ERRNO.H 

x Long double-precision floating-point value 

Returns The result of a Bessel function of x; -_LHUGE_VAL if x is negative 
errno EDOM 


Returns the Bessel function of the second kind (order 0). Long double-precision floating- 
point version of yO. 
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